Difference between revisions of "WikiCleanup"

From Nottinghack Wiki
Jump to navigation Jump to search
(→‎Priority List: Talk:WikiCleanup)
(→‎Photos: Remove some unneeded or completed actions)
 
(206 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{draft}}
 
 
{{Project
 
{{Project
|image=File:LogoOrig.svg
+
|image=File:Hackwiki.svg
 
|name=WikiCleanup
 
|name=WikiCleanup
 
|primary=
 
|primary=
Line 13: Line 12:
 
|livestatus=
 
|livestatus=
 
|qrmode=1
 
|qrmode=1
 +
|LookingforCollaborators=yes
 
}}
 
}}
:{{Note|''We're aiming to meet on the [[WikiCleanup#Wiki meetups|second Wednesday of each month]] to manage the cleanup project and help members interested in contributing. The next meeting is scheduled for '''13 March 2019 at 6pm'''.''}}
+
{{TOC right|2}}
  
 
This wiki has been in place since at least 2012, and many pages have not been updated in years. There are pages for [[:category:Tools and Equipment (Defunct)|tools we no longer have]], outdated pages on tools we do have, and a lack of information on newer tools and on our teams and how the space works. The plan is to bring this wiki back up to date, and make it a better resource our members find useful and interesting.
 
This wiki has been in place since at least 2012, and many pages have not been updated in years. There are pages for [[:category:Tools and Equipment (Defunct)|tools we no longer have]], outdated pages on tools we do have, and a lack of information on newer tools and on our teams and how the space works. The plan is to bring this wiki back up to date, and make it a better resource our members find useful and interesting.
Line 21: Line 21:
  
 
==How to help==
 
==How to help==
You can help by simply picking any page at all and updating it! '''Be Bold''' with your changes, nothing is lost when the wiki is edited; We can always revert back.  
+
You can help by simply picking any page at all and updating it! '''Be Bold''' with your changes, nothing is lost when the wiki is edited; We can always revert back.
  
Every wiki page has a [[Help:Talk_pages|discussion page]] (see tab at top left of page). For general wiki discussion or to request help there is the #wiki channel on [https://nottinghack.slack.com Slack].
+
Every wiki page has a [[Help:Talk_pages|discussion page]] (see tab at top left of page). For general wiki discussion or to request help there is the #comms channel on [[Discord]].
  
 
==Priority List==
 
==Priority List==
  
Priorities listed by topic - need to tag priority level - or order.
+
Priorities listed by topic - {{todo}} tag priority level (high {{high}}, med {{med}}, low {{low}}).
  
;Reorganisation of project pages;
+
===Page content and maintenance===
 +
====Missing tool pages====
 +
There are a number of tools in the space which aren't documented. A tool is worth documenting if it's particularly loved or well used. It's especially worth adding a page for if there is any safety or maintenance details to share.
  
* Maybe have separate subcategories for projects that of large 'Projects (by team)' and ones that are more or less solo 'Projects (by member).
+
Here are some requests for specific tools:
  
*Add [[Template:Project]] infobox to projects.
+
* Axminster Bandsaw
:75 Projects are using it as of 06/02/2019
+
* A 'portable' Mitre saw (as you walk in its on the far side).
:Close out old projects by marking them as Complete or Dormant
+
* There's also manual ones under one of the work benches in the non dusty area (AKA workshop)
 +
* Page for oscilloscopes we have, as purchased from pledges [[Electronics Test Kit Pledge]] and [[Oscilloscope Pledge]]
 +
* Page for badge maker, from [[Badgemaker pledge]]
  
* Encourage general membership to post projects.
+
===Location pages and maps===
:Even just a picture is ok, big essays are not necessary :) - how? see [[Talk:WikiCleanup#Encourage general membership to post projects|talkpage]]
+
* Standardise floor images, using SVG
  
*The [[Projects]] page needs purging and re-writing. See talk page at [[Projects]]
+
===Physical link to space===
 +
* Reprint some QR codes stickers/tags in space that link to relevant wiki page
 +
** QR code link on left-hand column needs testing - to ensure it links to right page.
  
===Deletion===
+
===Encourage participation in Wiki===
The wiki is fairly old and has a lot of pages that haven't been updated in years. Pages that genuinely aren't required can be tagged with:
+
* Encourage general membership to post projects.
<pre>{{delete|date=xx/xx/xxxx|reason=xxx}} </pre>
+
:: Even just a picture is ok, big essays are not necessary :)
 +
::- how? see [[Talk:WikiCleanup#Encourage general membership to post projects|talkpage]]
  
Please also include a reason which will be discussed at the next meeting.
+
====Good wiki practice====
 +
* List all the namespaces and their functions Help: Category: etc. (partially done at [[Help:Quick reference#Namespaces]])
 +
* Encourage use of edit comments.
 +
* Encourage wikilinking (Perhaps trawl through [[Special:LonelyPages]] and update where possible?).
  
Most pages that contain historic pages can be de-categorized and tagged with [[Template:archive]]
+
===Naming conventions and categories===
 +
* Have a naming convention for categories template etc. - for example, only capitalise first letter unless proper noun. Start with category type word first, for example, 'Category:Templates emoji'  rather than 'Emoji templates'.
 +
* Move articles that have been placed at the top of a category pages, for example [[:Category:Rules]] and previously [[:Category:Network]]. Move them back to article space.
  
===New pages===
+
===Adding dates===
====Hackspace Information====
+
* A lot of the information on the wiki is lacking dates. This can be helped by adding date= parameter to any relevant template. Also categories like [[:Category:Project started in 2012]], [[:Category:Tools and Equipment acquired in 2013]] etc. could help.
*As part of a wider documentation project in the hackspace we should create a page for each area of the space, and keep all relevant information on the wiki for members and guests to view.
 
*Add area infobox with map showing location.
 
* Write [[About:History]] Page
 
:([[:Category:Featured]] - our story pages may help)
 
* Write [[About:The Space]] Page
 
* Sort out :[[:Category:Featured]]
 
:It currently contains an article that should be moved to [[Featured]]
 
* Update [[Hackspace 2.5]].  
 
:This is quite a big one that it feels like people want to see more about.
 
* Encourage Teams to update their [[Team:]] pages with current contacts/ members
 
  
====Front page====
+
===Style===
[[File:Wiki comakingspace.de MainPage links table.PNG|thumbnail|A nice table taken from the front page of CoMakingspace Hackspace wiki in Germany]]
+
* Decorate infoboxes' as appropriate. For example, text white on dark green used in [[Template:Tool]].
*Convert 'list boxes' into template.
+
* List of currently coded styles - for example there is a style for the boxes on the front page (-early 2019)
*Tidy alignment.
+
* Add fancy CSS
*Highlight featured pages.
+
* Add long-winded or frequently used styles (esp. table) to CSS
*Make it easier to find task like tidying/ cleaning
+
* CSS to scale images by page percentage [https://stackoverflow.com/questions/9078157/is-there-a-way-automatically-to-resize-mediawiki-images-depending-on-screen-size see example]
*Make it clear how to contribute to the wiki
+
* Make CSS for style used in tables on [[power]] page {{high}}
*Change the sidebar links so that they link to Pages [https://en.wikipedia.org/wiki/Portal:Featured_content (Or Portals like this?)], Not categories
+
* Make CSS for style on template LinkTable and [[Community links]]
*No list to members guide
 
*New Members - link to members guide - wiki is second place to look for more detail
 
{{clear}}
 
  
===Tools and equipment===
+
===Photos===
* Add some how-tos and reminders.
+
* Clear [[:Category:Pages requiring photo]] list.
* Add [[Template:Tool]] infobox to Tools & Equipment pages
 
:12 Tools are using it as of 24/01/2019
 
* [[Tools/We_Have]] could be useful page - need updating - links to tool page if relevant, images don't need to be with 'thumb' borders.
 
  
===Locations===
+
===Categories===
Each [[:category:location|location]] ie, room, area and storage place could have a page. This in turn could link to pages of what is in that area and vice-versa. Location pages could have an infobox with a floor plan image indicating where it is.
 
  
===Wiki documentation===
+
====Tools and equipment====
*List all the namespaces and their functions Help: Category: etc. (partially done at [[Help:Quick reference#Namespaces]])
+
All the Textile Workshop tool need re-categorising as Tools and Equipment in Craft Room (by change location in Tools infobox)
*Encourage use of edit comments.
 
*Encourage wikilinking (Perhaps trawl through [[Special:LonelyPages]] and update where possible?).
 
  
===Naming conventions and categories===
+
====Categorise all uncategorised pages====
 +
* Categorise all uncategorised pages. Especially useful for template pages, as it avoids making a template that already exists. We could make a tag for uncategorised pages. See [[Special:SpecialPages]]
 +
** [[Special:UncategorizedTemplates]]  (7) {{med}}
 +
** [[Special:UncategorizedPages]] (136) {{med}}
 +
** [[Special:UncategorizedFiles]] (~1,316) {{low}}
  
*Have a naming convention for categories template etc. - for example, only capitalise first letter unless proper noun. Start with category type word first, for example, 'Category:Templates emoji'  rather than 'Emoji templates'.
+
* Add categories to Widget: pages {{med}}
*Move articles that have been placed at the top of a category pages, for example [[:Category:Rules]] and previously [[:Category:Network]]. Move them back to article space.
 
  
===Adding dates===
+
* Many team pages have a category closely associated with them - add relevant pages (for example, [[Team:Metalworking]] will have many pages for [[:category:Metalwork]])  {{med}}
A lot of the information on the wiki is lacking dates. This can be helped by adding date= parameter to any relevant template. Also categories like [[:Category:Project started in 2012]], [[:Category:Tools and Equipment acquired in 2013]] etc. could help.
 
  
===Style===
+
====Inter linking pages====
Make infoboxes' top text white on dark green (like boxes on front page). For example, [[Template:Tool]].
+
* Categories should help readers discover pages by subject. Another way to aid discovery is to link from other relevant pages. See [[Special:WhatLinksHere]] in the left hand column. If no other page link to the page can be another reason for readers not finding it.
  
===Rule pages===
+
===Archiving===
Rules are no longer updated on wiki (since 2016), make template for rule pages saying historical and pointing to [https://rules.nottinghack.org.uk/ rules.nottinghack.org.uk].
+
* Archive pages with historical information
 +
::Test example of archive style [[Old Wood lathe]] using <nowiki>{{grey-start}}</nowiki>
  
===Encouraging wiki editors===
+
===MediaWiki extensions===
*Welcome template.
+
Most or all extensions will have to wait until the MediaWiki software is upgraded, as per March meeting. However, preparity research can be done - find out the best extension for a particular use and what MediaWiki version it needs.
*Meetup for editors.
+
* Better search {{high}}
*Update MediaWiki software/settings to allow thanking for contributions. Enable [[Wikipedia:WYSIWYG|WYSIWYG]] editing?
+
** Main search could be set to search all pages (apart from media) to make it easier to find pages in namespaces with a prefix
 +
** Would it be possible to search rules, guide and wiki all-in-one?
 +
* Wiki notifications {{med}}
 +
** [[Wikipedia:Template:Ping|Ping]] wiki users
 +
** Send thanks for edits 
 +
* Semantic Wiki - data structure for pages, allows form -> infobox
 +
* Extension for dynamic display of Categories within a page
 +
** [https://www.mediawiki.org/wiki/Extension%3aCategoryTree Extension:CategoryTree] and/or
 +
** [https://www.mediawiki.org/wiki/Extension%3aDynamicPageList_%28Wikimedia%29 Extension:DynamicPageList (Wikimedia)]
 +
* Tooltips
 +
* [[WikiPedia:WYSIWYG|WYSIWYG]] editing, two main contenders:
 +
** [[MediaWikiWiki:Extension:VisualEditor]] pros: native editor handles tables and templates well, can generate detailed reflinks, cons: harder to install, needs to use older version for MediaWiki 1.32 (as NHack on [[Special:Version|1.32]], latest version of extension needs 1.35-alpha)
 +
** [[MediaWikiWiki:Extension:TinyMCE]] pros - easier to install, can use TinyMCE plugins, latest version works on MediaWiki 1.23+, cons: non native so less tight integration
 +
* Ignore caps on wikilinks (for example, using [[:Category:Utility templates]] would still link to [[:Category:Utility Templates]])
 +
* Something to display the number of page views
 +
* Extension:InputBox - for easy new page creation [https://www.mediawiki.org/wiki/Help:Starting_a_new_page#Using_article_creation_template code]
  
===Photos===
+
====Mobile phones====
*Photos are great! If a photo is needed, any page can be tagged with [[Template:Photo]].  
+
* Serve styles better suited to mobile phones, see [https://www.mediawiki.org/wiki/Manual:Mobiles,_tablets_and_responsive_design Manual:Mobiles, tablets and responsive design] {{high}}
*Also, many photos are on the flickr, unfortunately a lot don't have descriptive titles.
 
  
===Categorise all uncategorised pages===
+
===Templates===
Categorise all uncategorised pages. Especially useful for template pages, as it avoids making a template that already exists. We could make a tag for uncategorised pages. See [[Special:SpecialPages]]:
+
* Infobox for [[Template:Event|Events]]
 +
* Infobox for Network locations
 +
* Welcome new wiki user template, should be used with substitution (update notes on [[Nottinghack Wiki:Maintenance]]).
 +
*Make template to get left string (see [[Wikipedia:Template:Padleft]] and [[Wikipedia:Template:Str left]]). This will allow images to be specified with or without File: prefix.
 +
* Make merge banner template.{{clarify|date=March 2019}}
 +
* Add optional date parameter to banner template missing this parameter.
  
* [[Special:UncategorizedCategories]] {{done|date=December 2018}}
+
===Widgets===
* [[Special:UncategorizedTemplates]] {{done|date=December 2018}}
+
* [[Widget_talk:Flickr#Bug_-_gallery_vanishes_on_reload]] - fix bug in Flickr gallery widget {{low}}
* [[Special:UncategorizedPages]] (136)
 
* [[Special:UncategorizedFiles]] (~1,316)
 
  
*Remove [[Special:UnusedCategories|unused categories]] if no longer useful.
+
===Tidy Pages===
*Add categories to Widget: pages
+
* Fix [[Special:DoubleRedirects]] ~30
  
* Many teams'pages have a category closely associated with them - add relevant pages (for example, [[Team:Metalworking]] will have many pages for [[:category:Metalwork]])
+
===Graphics===
 +
Icons needed to replace 'H's in lower three boxes on frontpage [[NottingHack]], and one for [[Template:Archive]].
  
===Topics needing better coverage===
+
==Wiki meetups==
* Try to get info crafty tools and arty things as these seem to have little documentation currently. Things like screen printing are totally absent from the wiki.
+
We meet on the second Thursday of each month to work on the wiki and other hackspace documentation. Members can also document their own projects. Meeting starts at 6pm in the [[Blue Room]].
 
 
===Archiving===
 
* Archive pages with historical information
 
** Test example of archive style [[Old Wood lathe]].
 
  
==Wiki meetups==
 
 
===Upcoming===
 
===Upcoming===
* 2019-03-13 Wiki meet up - Process pages tagged to Delete
+
* 2020-01-09 Wiki meetup - continue work on improving floor plans, ~50 pages need updating see see [[:Category:Pages_for_Update]], revise WiiCleanup - move outstanding jobs to Trello?
* 2019-04-10 Wiki meet up - ?
+
* 2020-02-13 Wiki meetup
 +
* 2020-03-12 Wiki meetup
  
 
===Past===
 
===Past===
 
* [[2019-02-13 Wiki meetup]] - Discussion on 'What is the wiki for?' and how to improve it
 
* [[2019-02-13 Wiki meetup]] - Discussion on 'What is the wiki for?' and how to improve it
 +
* [[2019-03-13 Wiki meetup]] - Process pages tagged to Delete, Nip round space for required photos: [[:Category:Pages requiring photo]]
 +
* [[2019-04-10 Wiki meetup]] - Wiki frontpage progress. Photos of the areas and equipment that require it.
 +
* [[2019-05-08 Wiki meetup]] - Move past events and pledges to (past) categories.  Archive and cross out any rule pages left.
 +
* [[2019-06-12 Wiki meetup]] - Added new [[Hackspace 2.5|downstairs]] room locations.
 +
* 2019-07-10 Wiki meetup - Tinkered with [[Template:Hack]] so it can link to Guide/Rule page and/or HMS page. Deprecated 'members' parameter on [[Template:Team]] (now held on HMS).
 +
* 2019-08-14 Wiki meetup - Meeting probably not happening due to wiki 'team' not being able to make it.
 +
* 2019-12-11 Wiki meetup - work on floor plans - mainly though about how it improve hackspace floorplans
 +
 +
==Done==
 +
* [[/done April 2019]]
 +
* [[/done June 2019]]
 +
 +
==See also==
 +
* [[Nottinghack Wiki:Maintenance]]
  
 
==Resources==
 
==Resources==
Line 146: Line 170:
 
* [https://wiki.hacman.org.uk HACMan wiki] - interesting use of CSS to change appearance of wiki
 
* [https://wiki.hacman.org.uk HACMan wiki] - interesting use of CSS to change appearance of wiki
 
* [https://meta.wikimedia.org/wiki/Wiki_color_formatting_help Wiki color formatting help]
 
* [https://meta.wikimedia.org/wiki/Wiki_color_formatting_help Wiki color formatting help]
 +
* [https://revspace.nl/Main_Page Revspace wiki] - dutch hackspace wiki that also uses semantic wiki
 +
===Nottinghack wiki===
 +
* [[Special:Version]] - MediaWiki version, plugins and config
 +
** [[WikiPedia:Special:Version]] - what's installed on Wikipedia
 +
* [https://github.com/NottingHack/website/blob/andromeda/public_wiki/LocalSettings.php Nottinghack Wiki settings (Github)]
 +
* [https://wiki.nottinghack.org.uk/api.php Nottinghack Wiki API]
 +
  
 
[[Category:ToDo]]
 
[[Category:ToDo]]
 
[[Category:Website]]
 
[[Category:Website]]
 
[[Category:Nottinghack Wiki]]
 
[[Category:Nottinghack Wiki]]
[[Category:Looking for Collaborators]]
 

Latest revision as of 17:58, 17 July 2024

WikiCleanup
Hackwiki.svg
Primary Contact
Created 03/11/2017‎
Completed
Dormant
Version
Members Various
Manufacturer {{{manufacturer}}}
Model {{{model}}}
Location [[{{{location}}}]]
GitHub / Repo {{{repo}}}
Status In Progress
Type Hackspace Infrastructure
Live Status
QR code

This wiki has been in place since at least 2012, and many pages have not been updated in years. There are pages for tools we no longer have, outdated pages on tools we do have, and a lack of information on newer tools and on our teams and how the space works. The plan is to bring this wiki back up to date, and make it a better resource our members find useful and interesting.

Its worth mentioning that our wiki is probably one of the better ones, when compared with other Hackspaces in the UK.

How to help

You can help by simply picking any page at all and updating it! Be Bold with your changes, nothing is lost when the wiki is edited; We can always revert back.

Every wiki page has a discussion page (see tab at top left of page). For general wiki discussion or to request help there is the #comms channel on Discord.

Priority List

Priorities listed by topic -  To do  tag priority level (high  , med  , low  ).

Page content and maintenance

Missing tool pages

There are a number of tools in the space which aren't documented. A tool is worth documenting if it's particularly loved or well used. It's especially worth adding a page for if there is any safety or maintenance details to share.

Here are some requests for specific tools:

  • Axminster Bandsaw
  • A 'portable' Mitre saw (as you walk in its on the far side).
  • There's also manual ones under one of the work benches in the non dusty area (AKA workshop)
  • Page for oscilloscopes we have, as purchased from pledges Electronics Test Kit Pledge and Oscilloscope Pledge
  • Page for badge maker, from Badgemaker pledge

Location pages and maps

  • Standardise floor images, using SVG

Physical link to space

  • Reprint some QR codes stickers/tags in space that link to relevant wiki page
    • QR code link on left-hand column needs testing - to ensure it links to right page.

Encourage participation in Wiki

  • Encourage general membership to post projects.
Even just a picture is ok, big essays are not necessary :)
- how? see talkpage

Good wiki practice

Naming conventions and categories

  • Have a naming convention for categories template etc. - for example, only capitalise first letter unless proper noun. Start with category type word first, for example, 'Category:Templates emoji' rather than 'Emoji templates'.
  • Move articles that have been placed at the top of a category pages, for example Category:Rules and previously Category:Network. Move them back to article space.

Adding dates

Style

  • Decorate infoboxes' as appropriate. For example, text white on dark green used in Template:Tool.
  • List of currently coded styles - for example there is a style for the boxes on the front page (-early 2019)
  • Add fancy CSS
  • Add long-winded or frequently used styles (esp. table) to CSS
  • CSS to scale images by page percentage see example
  • Make CSS for style used in tables on power page  
  • Make CSS for style on template LinkTable and Community links

Photos

Categories

Tools and equipment

All the Textile Workshop tool need re-categorising as Tools and Equipment in Craft Room (by change location in Tools infobox)

Categorise all uncategorised pages

  • Add categories to Widget: pages  

Inter linking pages

  • Categories should help readers discover pages by subject. Another way to aid discovery is to link from other relevant pages. See Special:WhatLinksHere in the left hand column. If no other page link to the page can be another reason for readers not finding it.

Archiving

  • Archive pages with historical information
Test example of archive style Old Wood lathe using {{grey-start}}

MediaWiki extensions

Most or all extensions will have to wait until the MediaWiki software is upgraded, as per March meeting. However, preparity research can be done - find out the best extension for a particular use and what MediaWiki version it needs.

  • Better search  
    • Main search could be set to search all pages (apart from media) to make it easier to find pages in namespaces with a prefix
    • Would it be possible to search rules, guide and wiki all-in-one?
  • Wiki notifications  
    • Ping wiki users
    • Send thanks for edits
  • Semantic Wiki - data structure for pages, allows form -> infobox
  • Extension for dynamic display of Categories within a page
  • Tooltips
  • WYSIWYG editing, two main contenders:
    • MediaWikiWiki:Extension:VisualEditor pros: native editor handles tables and templates well, can generate detailed reflinks, cons: harder to install, needs to use older version for MediaWiki 1.32 (as NHack on 1.32, latest version of extension needs 1.35-alpha)
    • MediaWikiWiki:Extension:TinyMCE pros - easier to install, can use TinyMCE plugins, latest version works on MediaWiki 1.23+, cons: non native so less tight integration
  • Ignore caps on wikilinks (for example, using Category:Utility templates would still link to Category:Utility Templates)
  • Something to display the number of page views
  • Extension:InputBox - for easy new page creation code

Mobile phones

Templates

Widgets

Tidy Pages

Graphics

Icons needed to replace 'H's in lower three boxes on frontpage NottingHack, and one for Template:Archive.

Wiki meetups

We meet on the second Thursday of each month to work on the wiki and other hackspace documentation. Members can also document their own projects. Meeting starts at 6pm in the Blue Room.

Upcoming

  • 2020-01-09 Wiki meetup - continue work on improving floor plans, ~50 pages need updating see see Category:Pages_for_Update, revise WiiCleanup - move outstanding jobs to Trello?
  • 2020-02-13 Wiki meetup
  • 2020-03-12 Wiki meetup

Past

Done

See also

Resources

Nottinghack wiki