Differences

This shows you the differences between two versions of the page.

--- wiki:vhswiki:editing [2026/02/13 12:57] – created admin
+++ wiki:vhswiki:editing [2026/05/26 22:46] (current) – amber
@@ Line 6: / Line 6: @@
 . [Create an account](/?do=register)
-. Ask on the #vhs-wiki channel on slack for edit permissions
+. Ask on the #vhs-wiki channel [on slack](/wiki/start#slack_chat) for edit permissions
 . Edit away! Rules of VHS do-ocracy apply - be excellent!
@@ Line 13: / Line 13: @@
 - 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](https://commonmark.org/help/) - this is the preferred way to write pages!
-- Pages that don't have that at the top, are written in dokuwiki [wiki syntax](https://new.vanhack.ca/wiki/syntax)
+- Pages that don't have a DOCTYPE at the top, are written in dokuwiki [wiki syntax](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](/tools) - one big page with sections, not many little pages.
+. 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.
+. 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.
+. 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.
+. For more about how the wiki is organized, [see the plan](/wiki/vhswiki/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
+## 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](/wiki/start#slack_chat) 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](/wiki/vhswiki/start)