How to Contribute Content to the Arctos Handbook

There are three kinds of content on the Arctos Handbook:

Arctos Handbook content can be created or edited by anyone who is a member of the ArctosDB “Users” team (see “How to Use GitHub for Arctos”). That team has “write” access to the ArctosDB/documentation-wiki repository in GitHub. Anyone can view the content, but you need to be added to the “Users” team by an ArctosDB administrator in order to make changes.

Curators/Collection Managers who want the ability to create or edit Documentation and “How-to Guides” should contact dustymc@gmail.com and ccicero@berkeley.edu in order to be added to the “Users” team. We encourage Curators/Collection Managers to engage students in writing “How-to Guides.” However, students will not be able to post them to the wiki site; instead, they will need to submit the content to a member of the ArctosDB “Users” team (e.g., their supervisor) who can then post the content.

Create New Content

---
title: How To Do Anything in Arctos
layout: default_toc
---

The Arctos Handbook supports a few other Front Matter attributes. We also support author and date as an attribute, that, when present, show on the rendered page. An example that (as of this writing) is live on the Handbook site is:

---
title: Agents
layout: default_toc
author: ArctosDB
date: 2016-12-01
---

As an important note, if you do not include front matter on your page, the page will fail to compile, and will return a 404 Page Not Found error. The title you provide is what shows up on the index pages.

Edit Existing Content

General notes

When creating relative links, use good Jekyll practices: write them like

Link to [this here page](/path/to/page.html)

Titles

DO NOT EDIT an existing title because that will change the URL and thus affect linked pages.

Add a Table

In the page where you want to insert a table, follow the guide for Organizing Data into Tables in Github

Add Images

Add Videos

Pro tip: Text editors

If you want to work on markdown content offline or just not in a browser, there are a number of great text editors to use. Here are some FREE favorites:

You can work on the repository locally by using Github Desktop