Wiki danger zones: Difference between revisions
Appearance
m →Related: Added link |
m →Guiding Principle: WoW |
||
| (One intermediate revision by the same user not shown) | |||
| Line 4: | Line 4: | ||
Avoiding these helps keep the wiki clear, practical, and maintainable. | Avoiding these helps keep the wiki clear, practical, and maintainable. | ||
== | == Words of Wisdom == | ||
When in doubt, prioritize clarity, usefulness, and flexibility over completeness. | When in doubt, prioritize clarity, usefulness, and flexibility over completeness. | ||
| Line 69: | Line 69: | ||
== Related == | == Related == | ||
* [[Contributing to This Wiki]] | * [[Contributing to This Wiki]] | ||
* [[ | * [[Local Group Toolkit]] | ||
Latest revision as of 03:20, 1 June 2026
Purpose
[edit | hide all | hide | edit source]Highlight common pitfalls that reduce the usefulness of the toolkit.
Avoiding these helps keep the wiki clear, practical, and maintainable.
Words of Wisdom
[edit | hide | edit source]When in doubt, prioritize clarity, usefulness, and flexibility over completeness.
Policy Dump
[edit | hide | edit source]Avoid copying official policies, bylaws, or governing documents.
- Link to official sources instead
- Summarize only what is needed for practical use
If information exists in multiple places, one of them will become outdated.
One True Way
[edit | hide | edit source]There is no single “correct” way to run a Local Group.
- Avoid presenting one approach as the only option
- Show alternatives when helpful
- Acknowledge tradeoffs
The goal is to support decision-making, not replace it.
Museum Effect
[edit | hide | edit source]Outdated content reduces trust.
- Update content regularly
- Revise or remove outdated guidance
- Archive when appropriate
Inside Knowledge
[edit | hide | edit source]Do not assume prior knowledge.
- Explain terms, acronyms, and processes
- Avoid local or region-specific shorthand
- Write for someone new to the role
Overload
[edit | hide | edit source]Too much information reduces usability.
- Avoid long, unstructured text
- Break content into sections or subpages
- Keep pages focused and scannable
If a page feels overwhelming, simplify it.
Duplication
[edit | hide | edit source]Repeated content creates confusion.
- Link instead of repeating
- Maintain a single source of truth
Over-Prescription
[edit | hide | edit source]Avoid turning guidance into rigid rules.
- Use flexible language (“consider,” “may,” “often”)
- Allow variation across Local Groups
Key Takeaway
[edit | hide | edit source]Aim for content that is:
- Clear
- Practical
- Flexible
- Maintainable