Contributing

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

Follow the file structure
Use markdown
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

Jekyll uses Liquid templating. Using {{, }}, {%, or%} in markdown will cause problems. Use {% raw %} ... {% endraw %} tags to wrap these characters.
Font awesome icon can be added to any markdown file using this includes:
```
  {% include icon.html i='fa-wrench' %}
```

You can add notifications using this includes:

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

This is the message for the notification

Run Site Locally

Jekyll requires ruby.

  bundle install
  bundle exec jekyll serve