This is an old revision of the document!
Editing the Wiki
To edit this wiki
- Ask on the #vhs-wiki channel on slack for edit permissions
- Edit away! Rules of VHS do-ocracy apply - be excellent!
Editing tips:
- Look for the edit button on the right side of any page, when logged in - it looks like a pencil!
- Pages that have
<!DOCTYPE markdown>at the top are written in commonmark markdown syntax - this is the preferred way to write pages! - Pages that don't have a DOCTYPE at the top, are written in dokuwiki wiki syntax
Organization tips
- In general we prefer a flatter design - don't make lots of little pages with one or two paragraphs on them, instead have one page with sub-sections. An example of this is the tools page - one big page with sections, not many little pages.
- Wiki pages
/wiki/somepageand wiki sections/wiki/somesection/are different. Note the trailing slash on the section URL. You can put sub-pages inside a section, so they are preferred for any case where you might want to split things into multiple pages. - When you visit
/wiki/(trailing slash) you're actually viewing the page/wiki/start- the “start” page is the default page in a section.
Editor types
There are three levels of access for users of the wiki. To get your access level raised, come to the #vhs-wiki channel on slack and let us know what you'd like to do!
- admin - can do everything
- user - can edit every page
- wiki - can edit all the pages in
/wikiplus/tools - newb - view only, new accounts get this level of access automatically
The newb access level exists, because that way you can create your own account - nobody has to make it for you - but we don't have to worry about spambots or malicious randos defacing our site.
The wiki access level is for any member that wants to share info with the rest of the membership. You can edit most pages on the site, but not the more “public facing” pages.
The user access level lets you edit the public face of VHS: the main landing page, the membership page, etc. There's a bit higher bar - you need to have a reason you want to change those pages - and you probably should clear the change with at least one other member.