Wiki Maintenance: Difference between revisions

From Pumping Station One
 
(27 intermediate revisions by 6 users not shown)
Line 1: Line 1:
This is the start of the Wiki Maintenance Group
The Wiki Maintenance Group is an ad hoc group of members that work together to improve the wiki in a variety of ways, generate some standard procedures, and help ensure the quality of PS:One's wiki. We hope that the Wiki will be something that members will find useful in their time at PS:One, a historical record and source of truth for the organization, and be generally useful for the broader online Hacker/Maker community.


Some ideas:
==Goals==
==Goals==
*Introduce new members to the process of editing the wiki
*Introduce new members to the process of editing the wiki
**create machine [[Template:EquipmentPage|equipment labels]]
**create [[Template:EquipmentPage|equipment labels and wiki pages]]
**add authorization details
**add authorization details
**navigation principles
**navigation principles
**basic syntax
**basic syntax
*Have a monthly meeting to edit the wiki
*Have a monthly meeting to edit the wiki
**Wine Wiki Wednesdays (borrowed from [https://www.i3detroit.org/wiki/Wiki_Wine_Workshop i3 Detroit])
**connect with other members directly on Discord #wiki-love
*Update equipment pages
*Update equipment pages
*Help inventory
**Aid areas, hosts, and volunteers report status, best practices, etc
*Account for all areas and volunteers - names, contact methods, handles
**should use user pages in the wiki?
*Help inventory all the equipment
**Get master equipment list from each area host
*Category and template creation
*Category and template creation
*Document and describe the organization structure - [https://docs.google.com/drawings/d/10im8sXQ0jGZtr_cJzWHMRsNIsdyGFJkdXJuixoSQEzc/edit?usp=sharing Diagram]
**Create an overarching plan/structure of wiki information
**History of PS:One
**Board, Officer, Committee, Area Host Procedures
**New Member Onboarding
*Introduce members to [[Special:SpecialPages]]
*Introduce members to [[Special:SpecialPages]]
*Networking Staging Page [[Networking Reorg Staging Page]]
==General Guidelines and Etiquette==
Consider reading [https://en.wikipedia.org/wiki/Wikipedia:Simplified_ruleset<nowiki> Wikipedia's Simplified Ruleset]</nowiki>
===add tags to pages that need updating===
'''<nowiki>{{NeedsUpdate|your reasons for deletion go here}}</nowiki>'''
=== [[:Category:Pages with broken file links|Category:Pages_with_broken_file_links]] ===
=== note that a piece of equipment has been removed ===
* edit the source
* in the "where:" type "Removed" (no quotations, capitalization matters)
* you should see a banner at the top of the page that says the equipment is removed


==General Wiki guidelines and etiquette will go here==
===finding candidates for deletion===
===finding candidates for deletion===
Candidates for deletion are pages that haven't been updated in a long time, are incomplete, abandoned. A question you may ask yourself: is the deletion improving clarity or wiki structure?  
Candidates for deletion are pages that haven't been updated in a long time, are incomplete, abandoned. A question you may ask yourself: is the deletion improving clarity or wiki structure?  
Line 61: Line 84:
* [[The Wiki]]
* [[The Wiki]]
* [[:Category:Broken Equipment]]
* [[:Category:Broken Equipment]]
* [[:Category:Candidates_for_deletion]]
* [[:Category:Candidates_for_deletion]] see category page for syntax - adds marked for deletion
* [[:Category:Outdated_pages]]
* [[:Category:NeedsUpdate]] - see category page for syntax - adds needs update banner
* [[Spaceops]]
* [[Spaceops]]
*[https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki Documentation for Semantic Mediawiki Extension]
*[[Wiki Editing]]
* [https://www.youtube.com/playlist?list=PLAPWFk6Q9aTdIusqKyCdErpuRe2WDgToz YouTube Tutorial Videos]
==Infrastructure Editors==
*who can edit the wiki infrastructure? [[User:Folf]]
*who wants to get access to edit the infrastructure? [[User:Tachoknight]]
*remove pages for deletion


==Tasks to do==
==Tasks to do==
*Check out the [https://docs.google.com/spreadsheets/d/1E54AmJ98iLOgkueaHV0eI7Im9mhVM8eAxwAiWeshSdg/edit?gid=0#gid=0 punch list]!
*all tools are categorized into each area.
**create list for area hosts to audit - remove old equipment, add new equipment pages
**any way to make area show a list of active machines only?
*Fix links that point internally but use external links (/wiki/ problem with bad links)
*develop strategy for determining orphan pages, and linking them. Lots of pages are categorized but not linked (any way to differentiate?)
*develop strategy for determining orphan pages, and linking them. Lots of pages are categorized but not linked (any way to differentiate?)
*Talk to Dave about including categories and special pages bar, or coming up with a better search in general
*come up with specific search queries for targeted actions
*de-duplicating information
*de-duplicating information: create a banner, roll duplicated information into less pages
*who can edit the wiki infrastructure? Toba, Hef, Daniel P, Doorman Dave
*who wants to get access to edit the infrastructure? Ron O, Adriana
*remove pages for deletion
*orphaned pages should exclude pages that are linked via categories
*orphaned pages should exclude pages that are linked via categories
*figure out if [[Special:Wantedcategories]] that do not have category: pages should be removed from the linking pages or created
*figure out if [[Special:Wantedcategories]] that do not have category: pages should be removed from the linking pages or created
Line 77: Line 112:
**I'd like to create a new template very similar to the candidates marked for deletion that has a reason or link to a new machine
**I'd like to create a new template very similar to the candidates marked for deletion that has a reason or link to a new machine
*add [[:Template:NeedsUpdate]] to pages with old, incorrect, or missing information
*add [[:Template:NeedsUpdate]] to pages with old, incorrect, or missing information
*roll duplicated information into less pages


==Ideas for improvement==
==Ideas for improvement==
*email digest to google groups/area host a list of broken tools automatically based on broken tool list
*email digest to google groups/area host a list of broken tools automatically based on broken tool list
*correlate member pages to list of current members, tag their user page as such
*correlate member pages to list of current members, tag their user page as such
==Wiki Overhaul==
[[User:Carlfk/meeting_notes]]
* Rename wiki to not have a colon in <code><nowiki>{{SITENAME}}</nowiki></code>


[[Category:WikiGnomes]]
[[Category:WikiGnomes]]
[[Category:Interest Groups]]