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

  1. Replace (remove) absolute wiki.freebsd.org links in pages with standard wiki links. Search: Pages containing "wiki.freebsd.org".

  2. Replace hardcoded (unprotected) email addresses with <<MailTo(email)>> macro. Search: Pages containing mailto: links or email addresses.

  3. Replace manual or hardcoded references or footnotes ([X]) with <<FootNote(text)>> macro.

Improve information accessibility & readability

  1. Add Table of Contents to the top of pages where appropriate, such as long and or complex pages with deeply-nested section hierarchies.

  2. 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.

  3. Format (prefix) system commands that don't require root $, and # commands that require root.

  4. Add linktext to bare URLs, unless it doesn't make sense to do so. Helps readability, and search engines.

    • Example: [[http://example.net/|example site]] not http://example.net/.

  5. Spell-check and proof-read articles. See Menu: More Actions -> Check Spelling.

  6. Review a RandomPage and improve it.

Improve content structure and discoverability

  1. Link to and/or categorise OrphanedPages.

  2. Review AbandonedPages for pages to add CategoryStale to, or delete.

  3. 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'.

  1. 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.

  2. Everything in this wiki is FreeBSD related. Remove references to FreeBSD or FreeBSD Project unless required to maintain meaning or context.

    1. This includes page names.
  3. Remove references to attachments / URLs that no longer exist.
    1. Try to find replacements/alternatives if possible.

Language

  1. Remove you, your, his, her language unless required to maintain meaning or context.

  2. Use singular they for 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).

  1. Rename pages with titles in abbreviated/acronym form to their FullNotAcronymName.

    1. Example: ASLR -> AddressSpaceLayoutRandomization.

    2. 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.

  2. Add link text (|link text) to bare URLs. Search: Pages containing bare URLs (test regex, has false positives)

  3. Replace links to external documents (PDF, images, etc) with attachments.
  4. Add width and height to image attachments so they're rendered nicely.


CategoryWiki CategoryContributing

Wiki/Contributing (last edited 2021-11-23T00:07:10+0000 by KubilayKocak)