Wiki Maintenance: Difference between revisions

From Pumping Station One
Skm (talk | contribs)
 
(29 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 23: Line 46:
===linking orphans===
===linking orphans===
===add redirects===
===add redirects===
* create redirects to single tool pages based on terms you would search to find that tool.
** If there is more than one tool redirect to a disambiguation page or a subsection that lists all those tools.
To add a redirect to an existing page (not another redirect) create a new page and add the following text
To add a redirect to an existing page (not another redirect) create a new page and add the following text
*<nowiki>#REDIRECT [[the page you'd like to redirect to]]</nowiki>
*<nowiki>#REDIRECT [[the page you'd like to redirect to]]</nowiki>
===change incorrect redirects===
===change incorrect redirects===
* all redirects should go to a specific page. If a redirect is relevant to another page or equipment make sure that is redirects there.
* all redirects should go to a specific page. If a redirect is relevant to another page or equipment make sure that is redirects there.
Line 58: 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 74: 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
==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]]

Latest revision as of 01:01, 6 March 2025

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.

Goals

  • Introduce new members to the process of editing the wiki
  • Have a monthly meeting to edit the wiki
    • Wine Wiki Wednesdays (borrowed from i3 Detroit)
    • connect with other members directly on Discord #wiki-love
  • Update equipment pages
    • 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
  • Document and describe the organization structure - 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
  • Networking Staging Page Networking Reorg Staging Page

General Guidelines and Etiquette

Consider reading [https://en.wikipedia.org/wiki/Wikipedia:Simplified_ruleset Wikipedia's Simplified Ruleset]

add tags to pages that need updating

{{NeedsUpdate|your reasons for deletion go here}}

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

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?

  • Some equipment pages may be candidates for deletion, but if there is valuable information in them consider making them historical pages.
  • If there is some information that would be useful or historical in a page consider moving that content to a more appropriate page or making the page historical.
  • Do not delete pages in user namespaces.

linking orphans

add redirects

  • create redirects to single tool pages based on terms you would search to find that tool.
    • If there is more than one tool redirect to a disambiguation page or a subsection that lists all those tools.

To add a redirect to an existing page (not another redirect) create a new page and add the following text

  • #REDIRECT [[the page you'd like to redirect to]]

change incorrect redirects

  • all redirects should go to a specific page. If a redirect is relevant to another page or equipment make sure that is redirects there.

deleting redirects

  • do no delete redirects in user namespaces
  • don't delete redirects unless the following are all true:
    • the redirect goes to another redirect or creates a loop or leads to a page or redirect that doesn't exist
    • and there are no pages linking to that redirect

locking pages

undeleting pages

commenting edits

  • when edits are made you should can use the signature button (second button to the right in the edit)--Rtystgeeke (talk) 16:54, 19 November 2016 (CST)
  • you can also type ~~~~ characters together to insert a timestamped signature when typing Skm (talk) 14:40, 3 December 2016 (CST)

creating your own user page

  • Log into the wiki
  • Typing wiki.pumpingstationone.org/user:your_user_name into your browser
  • Click the create button in the upper right corner
  • Edit your page with your info, tools you know, things you want to learn, and any applicable categories
  • Users who are interested in wiki maintenance can edit their user page and add this text to their User page: [[Category:WikiGnomes]]
  • If you want to be fancy you can create a redirect by making a new page (with your name or nickname) as the page title and then type REDIRECT#User:(your user name)

Links to important pages

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

  • Check out the 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?)
  • come up with specific search queries for targeted actions
  • de-duplicating information: create a banner, roll duplicated information into less pages
  • 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
  • fix Category:EquipmentPageErrorNoAreahost so that all equipment belongs to an area host or member
  • add Category:Retired_Equipment Equipment to equipment that has wiki pages but is deprecated for some reason
    • 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

Ideas for improvement

  • 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

Wiki Overhaul

User:Carlfk/meeting_notes

  • Rename wiki to not have a colon in {{SITENAME}}