Website section for base guides

[jasonkuhrt]

What

• Content that guides users through particular domains

Why

• A place to send brand new users to
• A place to develop concepts around niche domains
• An at-a-glance index of domains we address or want to address

How

• We should strive to avoid overlap between guide content and cookbook content

• VueJS Cookbook directly addresses this schism, learn from their approach, maybe we also want to mention something similar in our content.

• Content structure idea:

  1. What is this domain?
  2. Why/when is this domain important?
  3. What features does santa have for this domain?
  4. What recipes are there that relate to this domain? (links)

• Areas to cover:

  introduction

  • what [can it do well]
  • why [does it work this way, and not x,y,z ways]
  • how [do you use it]
  • when [is the target use-case]
  • who [is the target audience]

  
  other...
  

  • logging
  • authoring plugins

Related

• Website #210

References

• https://vuejs.org/v2/cookbook/#The-Cookbook-vs-the-Guide

[jasonkuhrt]

Per discussion with @Weakky the following guide sections will be extracted into their own issues. These issues have larger scope because they require more research and maybe api ideation + implementation.

• databases
• authentication
• authorization
• testing

[jasonkuhrt]

We have a first version of logging and plugin guides shipped. The ambition/precision listed in this issue is too much for a v1. But the ideas are still valid. Let's revisit in the future.