Editing the Wiki

To edit this wiki

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

Editing tips:

Organization tips

  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:

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!

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