This page is for future users who want to edit this handbook or who want to make a handbook of their own.
Fork a Copy: The easiest way to adapt this handbook is to clone the Group Handbook repo from the Kulkarni Group Github and edit it yourself. See below for editing details.
Starting your own copy: To make your own handbook, start a Github repository and begin adding pages written in markdown formatting. Make sure the page titles have no spaces and end with .md. This will help with converting your handbook to a website.
See here for a Markdown guide. Though knowing basic Markdown will serve most of your needs, it is useful to know that Github uses slightly different Markdown called "Github Flavored Markdown" which differs in some places.
Make bold text using **example text**, italics using *example text*, and code using `example_text`. Numbering, bullet points (using dashes), and even tables are easy to write in Markdown.
Put several hashes in front of your heading, more hashes means a smaller heading. For example ### Heading will be smaller than ## Heading when the document is rendered.
Internal Links: The syntax is simple for linking to another page within your repository. Simply write [link_title](file_name.md) where "link_title" can be any label you want and will show up as blue text, while "file_name.md" is the precise title of the page you want to link to (case sensitive). For example, [example](Introduction.md) would link the the introduction of this handbook.
External Links: The syntax follows the same rules as an internal link except instead of the file name, you place a URL in the parenthesis. For example, to link to the Kulkarni group website, write [example](https://kulkarni.sf.ucdavis.edu/)
Github Pages makes it easy to convert a repo directly into a website, however, it can be pretty expensive if you have several contributors to a repo. Additionally, the repository has to be public to produce a website. You can host the website for free and incorporate new contributions by making a public repository in someone's individual account, cloning the original handbook repository to it, and, in your new repository settings, selecting a source and theme for your webpage in the "GitHub Pages" section. You can incorporate new changes by adding them to the individual repository which supports the website.