How to Edit the Wiki
Overview
The wiki is hosted on GitBook. For more information, check out their documentation.
Method 1: Open a Change Request on GitBook
When to use
Making more than a few edits to the Wiki
Information
Change requests are saved automatically
Your can access your change request draft at any time by clicking "Change Requests" in the upper left hand corner
For more information see the GitBook documentation
Guide
Sign up for GitBook
Get an invite to the organization (email your Khalil lab contact)
Navigate to the eVOLVER Wiki by switching organization to Khalil Lab
Click "Edit" in the top right corner to open a Change Request
Use the GitBook editor to make your changes
Try to match existing formatting
Follow our formatting guidelines, especially for links
Once finished with changes, click "Submit for review"
Your request will be reviewed and possibly edited before being merged with the Wiki
Be sure to update your change request if you are prompted, because that means someone else has merged a request elsewhere. It also means some functions won't work until you update.
Method 2: Comment on GitBook
When to use
Suggestions, opening a discussion, or questions
Making only a few edits to the Wiki
Guide
Sign up for GitBook
Get an invite to the organization (email your Khalil lab contact)
Navigate to the eVOLVER Wiki by switching organization to Khalil Lab
See the GitBook documentation
Method 3: Edit on GitHub
Less recommended because it does not translate Markdown
Does not require joining GitBook, only requires GitHub account
Click "Edit on GitHub" on the right hand side of the page you want to edit. (Or click on the three dots next to the title to show it)
Resources
Wikipedia's list of guidelines
Content Structure
Page Content
What content goes in a page?
What content doesn't go in a page?
Long blocks of code
Reference to a forum post discussing the code
Exception: where code is walked through line-by-line as an illustration
Links to subpages in a table of contents
Subpage Content
Content specific to subpages - anything not listed is the same as pages
Formatting
Links
Shortcuts (will not work in block edit mode): cmd + K (Mac) or ctrl + K (Windows)
Usage:
Pointing towards pages, subpages, or paragraphs on this wiki
Formatting:
Internal links should be relative, otherwise they will not be updated when the title or location changes
Internal links should be formatted using the inline pane
This looks like this (when text is highlighted before clicking on the inline text editing box above the cursor)
Or this: eVOLVER Community (when no text is highlighted before clicking on the inline text editing box above the cursor)
Block-level internal links are very large and should not be used (such as the following):
Usage:
Cite information as part of a page
Refer to a forum post on the topic - for questions, data, and detailed discussion
Refer to a specific place in a GitHub repository
NOT for referencing an eVOLVER Wiki page
Formatting:
Last updated
