Spike - beginner questions, gotchas & tips - a list of things that either tripped me up, or needed extra explanation

spike-beginner.md

Spike Beginner Thoughts

This is a WIP list of things that either tripped me up, or needed extra explanation and research before I really understood them. This may serve as a starting point for tutorial style articles, or additions and improvements to Spike's documentation.

sugarml / reshape

1. Includes - the fact that you can use includes as a simple component because inludes receive their parent scope variables
2. Conditionals - if statements in reshape silently fail if there is a stray space at the end of the line
3. Loops - difference between of and in
4. Local functions - using them as 'mixins' - showing a couple of examples would be great. Need to use {{{ }}} 3 curlies rather than 2
5. Markdown - Why do I need to require and use something like marked when markdown-it is already integrated into reshape-content? See the (FAQ)[https://spike.readme.io/docs/faqs#section-markdown-processing-locals]

app.js config

1. Plugin config - tutorial/walkthrough on hooking up DatoCMS or Contentful for example and using features (transforms, json, etc.)
2. spike watch - not firing on ignored files (like template files or partials)
3. Using and importing .env file to store tokens / secrets etc. (this is pretty common, but may still be worth documenting)

PR ideas

1. Reshape responsive <picture> element
2. Dato image helper (grab the asset URL and drop it in front of image resources)