This is an old revision of the document!
Introduction
This page outlines easy things that anyone can do to improve the wiki. If you have any questions or ideas for this page, get in touch with WikiAdmin.
Fix incorrect markup
- Replace (remove) absolute
wiki.freebsd.orglinks in pages with standard wiki links. Search: Pages containing "wiki.freebsd.org"
- Replace hardcoded (unprotected) email addresses with MailTo macro. Search: Pages containing mailto: links or email addresses
- Replace manual or hardcoded references or footnotes ([X]) with Others macro
Improve information accessibility & readability
- Add Table of Contents to the top of pages where appropriate, such as long and or complex pages with deeply-nested section hierarchies.
- Format text that references file contents or system commands using codeblocks or monospace markup. Use monospace for single-line or inline, and codeblocks for multi-line content.
- Format (prefix) system commands that don't require root
$, and#commands that require root. - Add linktext to bare URL's, unless it doesn't make sense to do so. Helps readability, and search engines.
- Example:
[[http://example.net/|example site]]not http://example.net/
- Spell-check and proof-read articles. See
Menu: More Actions -> Check Spelling - Review a RandomPage and improve it.
Improve content structure and discoverability
- Link to and/or categorise OrphanedPages.
- Review AbandonedPages for pages to add CategoryStale to, or delete.
- Move pages that appear predominantly personal projects, work or references, to that person's Personal/namespace (Fix referent links after doing this).
Remove duplicate, redundant or outdated information
Information that is duplicated, redundant (provided elsewhere), or otherwise requires updating in multiple places if the name or reference changes, should be removed, and replaced with a link to the 'canonical reference'.
- Replace
username@FreeBSD login (committer) references with a link to the committers home page. If the home page does not contain username/login reference, add it. - Everything in this wiki is FreeBSD related. Remove references to FreeBSD or FreeBSD Project unless required to maintain meaning or context.
- This includes page names.
- Remove references to attachments / URLs that no longer exist.
- Try to find replacements/alternatives if possible.
Language
- Remove you, your, his, her language unless required to maintain meaning or context.
- Use singular
theyfor 3rd-person pronouns unless a specific pronoun is requested by someone.
Potential Things
Don't do these things yet. If you'd like to, discuss on #freebsd-wiki (Libera.Chat IRC).
- Rename pages with titles in abbreviated/acronym form to their FullNotAcronymName.
- Example: ASLR → AddressSpaceLayoutRandomization
- NOTE: Check for and update all referents when renaming pages. If referents exist in Google/Search Engine. Create a redirect at the old name pointing to the new one.
- Add link text (
|link text) to bare URL's.Pages containing bare URL's (test regex, has false positives)
- Replace links to external documents (PDF, images, etc) with attachments.
- Add width and height to image attachments so they're rendered nicely.