Editing the Wiki

1. Create an account
2. Ask on the #vhs-wiki channel on slack for edit permissions
3. Edit away! Rules of VHS do-ocracy apply - be excellent!

• 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

1. 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.
2. Wiki pages /wiki/somepage and 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.
3. When you visit /wiki/somesection/ (trailing slash) you're actually viewing the page /wiki/somesection/start - the “start” page is the default page in a section.
4. If you want to move things around, don't be shy - just make sure to ask an admin to make redirects so links to the old pages aren't broken.
5. For more about how the wiki is organized, see the plan, but in short it's:

• /* the top-level, is reserved for very-public facing stuff - i.e. stuff that's linked from the top navigation bar - what we are, how to join, etc.
• /tools has a list of all the tools - this is the page people visit when they want to know if VHS has a Plumbis for realigning their Winglehop 2000.
• /wiki/groups/$GROUPNAME/start is the home for individual groups/committees/areas at VHS
• /wiki/vhs/ is for stuff related to VHS, membership, policy etc.
• /wiki/resources/ is for misc stuff that doesn't belong above

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 /wiki plus /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.

More technical details about the wiki