DOCページの作成ガイドを用意する

[chris-sporelab]

DOCのページを作成・編集する際に参照できるガイドをWikiなどで用意するのはいかがでしょうか？

以下の内容を含むといいと思います。

• 各種類のページ向けの構成テンプレート（ページの種類として基本的に「紹介」と「チュートリアル」、「機能の説明」という３つあると思います）
• enebularの主要的な概念の参考定義
• その他のガイドライン

[chris-sporelab]

チュートリアルの構成テンプレートとしては以下ような感じがいいと思います（英語）。

• Introduction
  • Covering what this guide covers
  • Why the user should care / why it’s important
  • What they can expect to know by the end of it
  • Where this component fits into the enebular whole
• Before you get started
  • Cover any instructions which need to be carried out before the core
    content of the guide can successfully carried out (such as setting
    up datasources (Milkcocoa), AWS Lambda, etc)
• Main guide content
• Examples of successful implementation
• Additional resources
  • Internal links to other guides
  • External links to other reference material
  • Links to support (community groups, enebular support, forums, etc)