Refactor based on review feedback

Place a general explaination at the top level
style guide and link to it from the vue and vuex
guides.