This repository contains documentation for the Aranya project website. Specs and documentation are written in Markdown, utilizing YAML Front Matter and then deployed to Github Pages using Jekyll. We used the Jekyll theme from lanyon as the basis of the site.
When you want to add a new spec or documentation page, you will create a new Markdown file in the /docs directory. This file will rely on Markdown for it's styling and hierarchy and Front Matter to communicate it processing information to Jekyll.
The key Front Matter information that every file needs is
layout: Layout tells Jekyll this is apagethat should be included in the menu.title: Title tells Jekyll the value to use in the menu.permalink: Permalink tells Jekyll the value to use in the page slug.
---
layout: page
title: "document-title"
permalink: /"url-slug"/
---
Before opening a PR, please test your changes locally. This ensures that formatting, links, and images have been thoroughly tested before anything goes live. See the Develop Locally section for instructions.
Once the PR has been approved, please test again locally before merging it in. This will give you a second chance to make sure no unwanted formatting issues were introduced while addressing feedback.