Assets documentation

[benjaminwil]

I’ve rewritten and expanded the documentation about assets in Solidus. I also split it into two articles.

The changes aren't incredibly significant, but here's a summary:

• I link back to relevant Rails documentation about manifests and the standard asset pipeline.
• When referencing the Solidus source in examples, I've made sure to update it to code that actually makes sense in master. (Previous references wouldn't have made sense if you looked at the corresponding source now.)
• I've highlighted how we recommend scoping assets to frontend and backend so nothing conflicts and how we don't really recommend overriding in the long term.
• I've stated clearly that the articles assume a typical Solidus installation (with solidus_frontend and solidus_backend).

In the future, I'd like to see more information about Solidus's asset manifests added.

This is part a larger project to improve Solidus's documentation. See this gist with the high-level table of contents. Where and how this documentation will exist is still up for discussion.

[tvdeyen]

Great. Only have some small nits :)

[tvdeyen]

any any

[tvdeyen]

I know this very picky, but could we use box drawing characters here? 😄

app|vendor
└─ assets
   ├─ images
   │  └─ spree
   │     ├─ frontend
   │     └─ backend
   ├─ javascripts
   │  └─ spree
   │     ├─ frontend
   │     └─ backend
   └─ stylesheets
      └─ spree
         ├─ frontend
         └─ backend

[tvdeyen]

vendor
└─ assets
   ├─ javascripts
   │  └─ spree
   │     ├─ frontend
   │     │  └─ all.js
   │     └─ backend
   │        └─ all.js
   └─ stylesheets
      └─ spree
         ├─ frontend
         │  └─ all.css
         └─ backend
            └─ all.css

I ❤️ box drawing characters

[benjaminwil]

❤️ Agreed

[tvdeyen]

Missing link

[benjaminwil]

I added this at the bottom of the section. Thank you.

[benjaminwil]

@tvdeyen Hey, I updated the asset management guide per your review. When you have a chance could you re-review?