Admin documentation
Notes for people who maintain pages, structure, and links on the Collage wiki.
This page is for people who help maintain the Collage wiki. The goal is a site that stays readable as the community grows.
Page structure
- Give each page one clear subject.
- Use a short descriptive title that matches the page content.
- Start with a one sentence summary.
- Use headings in order, without skipping levels.
- End with related links so a reader can continue.
Naming and URLs
Keep page names stable once they are linked from other pages. If a name must change, update every link and add a short note on the old page so readers can find the new one. Internal links should point to pages that exist.
Using templates
Class pages use the class template. Curricula use the curriculum template. Member pages use the profile template. A template keeps the basic facts in the same place on every page.
Recent changes
Review Recent Changes for accidental edits, broken links, and pages that have drifted out of date. Small, regular review is easier than a large cleanup.
Accessibility
- Write descriptive link text instead of "click here".
- Add alt text to images that carry meaning.
- Keep headings in a logical order.
- Do not rely on color alone to explain something.
- Test pages on a narrow screen as well as a wide one.
Licensing and credit
Content is shared under a Creative Commons Attribution 3.0 license unless a page says otherwise. Credit the people and sources behind a page, and see Copyrights for the full note.
Maintenance checklist
- Every page is listed in All Pages.
- Every internal link opens a real page.
- Every class page has a guide and a meeting rhythm.
- Every image has alt text.
- Every page has a clear title and description.