Contributing to This Wiki: Difference between revisions
m →Key Takeaway: Added litmus test and related |
m Restructured |
||
| Line 3: | Line 3: | ||
The goal is to make it easy to add useful content while keeping the wiki clear, practical, and organized. | The goal is to make it easy to add useful content while keeping the wiki clear, practical, and organized. | ||
== Guiding Principle == | |||
Contribute in ways that help others succeed more easily. | |||
Small, practical improvements are more valuable than large, complex additions. | |||
== Who Can Contribute == | == Who Can Contribute == | ||
Anyone with relevant experience or insight can contribute: | Anyone with relevant experience or insight can contribute: | ||
* Local Group officers | * Local Group officers | ||
* Volunteers | * Volunteers | ||
| Line 13: | Line 20: | ||
If something would have helped you, it will likely help someone else. | If something would have helped you, it will likely help someone else. | ||
== | == Key Actions == | ||
=== Start Small === | |||
You don’t need to write a full page. | You don’t need to write a full page. | ||
{| class="wikitable" | |||
! Type of Contribution !! Example | |||
|- | |||
| Improve clarity || Rewrite a sentence to be easier to understand | |||
|- | |||
| Add a tip || Include a helpful suggestion from experience | |||
|- | |||
| Share a resource || Add a template, checklist, or example | |||
|- | |||
| Update content || Fix outdated or unclear information | |||
|} | |||
=== Add Content in the Right Place === | |||
* Find the most relevant existing page | * Find the most relevant existing page | ||
* Add your content there when possible | * Add your content there when possible | ||
| Line 31: | Line 46: | ||
If a page feels too long, consider suggesting a subpage instead. | If a page feels too long, consider suggesting a subpage instead. | ||
=== | === Keep It Practical === | ||
Focus on content that helps someone take action. | Focus on content that helps someone take action. | ||
Ask yourself: | Ask yourself: | ||
* Does this help someone do their role? | * Does this help someone do their role? | ||
* Is it clear and easy to follow? | * Is it clear and easy to follow? | ||
* Can other groups use this? | * Can other groups use this? | ||
=== | === Use Clear, Simple Formatting === | ||
* Use headings to organize content | * Use headings to organize content | ||
* Use bullet points for readability | * Use bullet points for readability | ||
| Line 47: | Line 65: | ||
Make it easy to scan. | Make it easy to scan. | ||
=== | === Link Instead of Repeating === | ||
* Link to | * Link to existing content instead of duplicating it | ||
* | * Maintain a single “source of truth” for each topic | ||
=== Share Real Examples === | |||
Examples are highly valuable: | Examples are highly valuable: | ||
* Sample emails | * Sample emails | ||
* Checklists | * Checklists | ||
* Processes that worked well | * Processes that worked well | ||
Include context for when and why something works, when possible. | |||
=== Be Flexible, Not Prescriptive === | |||
Local Groups operate differently. | Local Groups operate differently. | ||
| Line 76: | Line 96: | ||
== When to Create a New Page == | == When to Create a New Page == | ||
Create a | {| class="wikitable" | ||
! Create a New Page If... !! Otherwise... | |||
|- | |||
| The topic is clearly distinct || Add to an existing page | |||
|- | |||
| The content would make a page too long || Suggest or create a subpage | |||
|- | |||
| It stands on its own as a useful resource || Expand existing content | |||
|} | |||
If in doubt, start within an existing page. | If in doubt, start within an existing page. | ||
== When You’re Unsure == | == When You’re Unsure == | ||
* Add a draft section and label it clearly | * Add a draft section and label it clearly | ||
| Line 91: | Line 114: | ||
* Start small — it can always be expanded later | * Start small — it can always be expanded later | ||
== Common Pitfalls | == Common Pitfalls == | ||
* Adding long, unstructured text | * Adding long, unstructured text | ||
| Line 98: | Line 121: | ||
* Turning guidance into rigid rules | * Turning guidance into rigid rules | ||
* Overcomplicating simple ideas | * Overcomplicating simple ideas | ||
See also: | |||
* [[Wiki danger zones|Wiki Danger Zones]] | |||
== Tone and Approach == | == Tone and Approach == | ||
| Line 111: | Line 137: | ||
You don’t need to contribute something perfect. | You don’t need to contribute something perfect. | ||
''Small, clear, practical improvements are what make this toolkit valuable over time.'' | |||
=== Litmus Test === | === Litmus Test === | ||
* Will this help a volunteer solve a problem in the next month? | * Will this help a volunteer solve a problem in the next month? | ||
== Related == | == Related == | ||
* [[ | * [[Local Group Toolkit]] | ||
* [[Wiki danger zones|Wiki Danger Zones]] | |||
Revision as of 14:08, 25 March 2026
Purpose
This toolkit improves through contributions from volunteers like you.
The goal is to make it easy to add useful content while keeping the wiki clear, practical, and organized.
Guiding Principle
Contribute in ways that help others succeed more easily.
Small, practical improvements are more valuable than large, complex additions.
Who Can Contribute
Anyone with relevant experience or insight can contribute:
- Local Group officers
- Volunteers
- Experienced members
- New volunteers with fresh perspective
If something would have helped you, it will likely help someone else.
Key Actions
Start Small
You don’t need to write a full page.
| Type of Contribution | Example |
|---|---|
| Improve clarity | Rewrite a sentence to be easier to understand |
| Add a tip | Include a helpful suggestion from experience |
| Share a resource | Add a template, checklist, or example |
| Update content | Fix outdated or unclear information |
Add Content in the Right Place
- Find the most relevant existing page
- Add your content there when possible
- Avoid creating new pages unless needed
If a page feels too long, consider suggesting a subpage instead.
Keep It Practical
Focus on content that helps someone take action.
Ask yourself:
- Does this help someone do their role?
- Is it clear and easy to follow?
- Can other groups use this?
Use Clear, Simple Formatting
- Use headings to organize content
- Use bullet points for readability
- Keep paragraphs short
- Avoid large blocks of text
Make it easy to scan.
Link Instead of Repeating
- Link to existing content instead of duplicating it
- Maintain a single “source of truth” for each topic
Share Real Examples
Examples are highly valuable:
- Sample emails
- Checklists
- Processes that worked well
Include context for when and why something works, when possible.
Be Flexible, Not Prescriptive
Local Groups operate differently.
- Offer suggestions, not rules
- Avoid “this is the only way” language
- Leave room for variation
Editing Guidelines
- Preserve useful existing content when possible
- Improve clarity rather than rewriting everything
- If making large changes, consider discussing first
- Keep tone consistent: practical, supportive, and neutral
When to Create a New Page
| Create a New Page If... | Otherwise... |
|---|---|
| The topic is clearly distinct | Add to an existing page |
| The content would make a page too long | Suggest or create a subpage |
| It stands on its own as a useful resource | Expand existing content |
If in doubt, start within an existing page.
When You’re Unsure
- Add a draft section and label it clearly
- Ask for feedback from others
- Start small — it can always be expanded later
Common Pitfalls
- Adding long, unstructured text
- Duplicating content across pages
- Writing highly specific local information
- Turning guidance into rigid rules
- Overcomplicating simple ideas
See also:
Tone and Approach
This toolkit should feel:
- Supportive, not critical
- Practical, not theoretical
- Clear, not overly detailed
- Helpful, not overwhelming
Key Takeaway
You don’t need to contribute something perfect.
Small, clear, practical improvements are what make this toolkit valuable over time.
Litmus Test
- Will this help a volunteer solve a problem in the next month?