Formatting, Tone, and Style

Blah blah something about formatting

Blah blah these are our organizational principles

Tone

Professional, personal, and nerdy are all fine. Try to keep the first-person "I" out of it if you can. If you have to use "I" try to make it clear who you are. Since a lot of content in here is from Cam's CT Handbook, there's legacy language that needs to be modified. We are working on it. 

Please Use Tags!

Tags are helpful in keeping the Almanac organized. Since some items are relevant in multiple places (e.g., software tools used in-tandem with hardware tools), tagging is another way to find information. 

How-To: Things That Belong In Multiple Locations

Should a Job Directory page be located under Finding Work or Directories?!

A book can live in two places, which is good, but what we really want is for pages to live in multiple places. To do this, we are referencing content from one page to another using Bookstack's references. For example, in the Finding Work section, we are referencing the page Job Board that lives in the Directories section.

To do this, you find the permalink number ID for the page you want to reference, and then you use the page tag below (replace the number). Please put a horizontal bar and an INFO formatted paragraph explaining that's what you're doing. 

If we replace "ID" below with "137", it will permalink to the parent Job Board page. Putting that on the child will make it so that any updates at the parent level, will happen at the child level, too.  

{{@ID#}}