If you know how to use GitHub and Asciidoc, then you’re pretty much ready to go! You can go straight to our Guidelines Page, and make use of our Sample Document for pre-made snippets of asciidoc formatting for links, footnotes, admonitions, etc.

However, most of us don’t know GitHub or Asciidoc. For you we have some extra links to help you get started.

In advance, let us ask you not to be discouraged by any learning curve!

It’s not that bad, really!

If you want to help by contributing your expertise to this project then you’re a patriot for Liberty and Justice for All.

Our struggles are not yet as bad as the ones our ancestors fought against oppression by slavery, Nazis, Mad Kings and Emperors. Hopefully learning a few new skills will be a price you are willing to pay. And you can reach out to us for help as we’ll explain a few lines down.

The first thing is to understand how you are viewing this page. There are two different ways you might be seeing it: 1) the Wiki, where we want the public to see and discuss and understand this material; and 2) GitHub, which is where people like yourself can edit and add.

If you are viewing this page from our Wiki, then there’s a pretty red bar with three buttons at the top of your screen, and the first of those buttons invites you to Help Improve This On GitHub.

You may have arrived at this page through GitHub itself, in which case you’re already viewing the very technical looking GitHub interface.

To make edits and changes, you’ll be working in the GitHub interface.

We chose GitHub because it is designed for large-scale development with very granular changed tracking and robust security tools. These have been road-tested for years in at-scale industries which are under state-level attack.

This security hardening and detailed tracking advantages bring with them some disadvantages of complexity, which these documents hope to help you overcome.

Easing that complexity is the goal of this set of documents:

If You Want to Help Improve These Pages. (This document.)

Overview of the Environment.

Adding and Editing Pages on GitHub.

How to Publish Your Contributions.

Guidelines and Standards for Pages.

A Sample Document to Copy and Modify.

FAQ: Frequently Asked Questions; and how to get more Help.

There is also a subreddit for discussion and support.

We also have a discussions area on GitHub itself.