CONTRIBUTING.md

title	category	layout
Contributing	home	page

Any additions to AppBuilder documentation is welcome. Here are few guidelines to keep our documentation consistent:

1. Follow the file structure
2. Use markdown
3. Follow the page format

File Structure

Try to follow the existing hierarchy when adding documentation. Add a page folder under the appropriate topic. Add a Page.md file, and an images folder if needed.

📁topic
  📁subtopic
    📁page
      📁images
      Page.md

Markdown

Learn Markdown

• Mastering Markdown - Github's markdown Guide
• Markdown Cheetsheet - Quick markdown reference

Tools

• Docs to Markdown - Google drive extension to convert an existing document to Markdown
• Markdown Tables Generator - Easy tool for creating/formatting a table into markdown

Format

---
title: My Page Title
category: Category
description: This description will show beside the title on the menu page.
---

## Heading

### Sub Heading

...

######

Front matter

The YAML front matter is processed by Jekyll and used to display the page on the correct category pages.

title - Page title
category - Which category page should link to this page.
description - (Optional) Adds a description to the Category Page to provide additional context.
icon - (Optional) a font awesome icon (starting with fa-). The icon will display in the breadcrumbs header.

Content

Start with heading 2 (##) and add one level for each nested heading. Do not skip levels.

Adding Categories

To add a category simply add a markdown file myCategory.md with the following yaml front matter:

title: My category
description: An optional description of my category
is-category: myCategory
layout: index
category: parentCategory
icon: fa-icon (optional)

This will create an index page linked from the parent category which list any page that uses the category myCategory

Tips

1. Jekyll uses Liquid templating. Using {% raw %}{{, }}, {%, or%} {% endraw %} in markdown will cause problems. Use {% raw %}{%{% endraw %} raw {% raw %} %} ... {% {% endraw %} endraw {% raw %}%}{% endraw %} tags to wrap these characters.
2. Font awesome icon can be added to any markdown file using this includes:

{% raw %}{% include icon.html i='fa-wrench' %}{% endraw %}

{% include icon.html i='fa-wrench' %} 2. You can add notifications using this includes:

{% raw %}{% include notification.html message="This is the message for the notification" %}{% endraw %}

{% include notification.html message="This is the message for the notification" %}

Run Site Locally

Jekyll requires ruby.

  bundle install
  bundle exec jekyll serve