1st step of a big wiki cleanup

155 views
Skip to first unread message

Peter "Sci" Turpin

unread,
May 28, 2013, 10:46:14 PM5/28/13
to london-h...@googlegroups.com
This evening I went through the entire hackspace wiki. *Every* content
page. I did this to make sure all the equipment pages were listed in the
correct category and not orphaned away from the new template &
organisational setup I've been working on.

As I was checking each page, I also added or changed some Category tags.
Most were missing any, some were mis-categorised.

Some of the categories I chose are extremely broad, but this is *on
purpose* because I'm going to come back to refine them later, so please
don't revert my category choices just yet. I don't want to have to go
back through all 400+ pages again. I found a bunch of pages that're in
the wrong namespaces too, which this will help sort out.

And don't panic, I'm not going to redact the "wiki/Section/PAGENAME"
structure from anything again like on the Stratasys' page, since people
seem to like it. I'll be doing categories in parallel. Why bother have
categories as well as namespace? Because they work nicely with Semantic
tables AND it's normal wiki formatting for categories.

This took many hours longer than I anticipated, so I'll be rolling out
the new template and automatic management page for equipment tomorrow.
I'll be looking forward to seeing what you all think and it'll hopefully
make it a LOT easier to keep equipment lists & status's up to date.
It'll show up where all the gaps are, so will probably look a little
ropey at first.

Seeya in the morning. My eyes have screen-burn. :P

Sci

Aaron Sokoloski

unread,
May 29, 2013, 3:12:37 AM5/29/13
to London Hackspace
Nice one, Sci.  Over the past few weeks I'd been quietly going through all the uncategorised pages and adding categories to them all, as well as cleaning up some of the category names that were a bit unconventional, but I was starting to burn out.  So thanks for this.  I'm interested to see the new changes you have in store, too.

Aaron

Mark Steward

unread,
May 29, 2013, 6:19:06 AM5/29/13
to london-h...@googlegroups.com
This is awesome, thanks Sci!


Mark




Sci

--
You received this message because you are subscribed to the Google Groups "London Hackspace" group.
To unsubscribe from this group and stop receiving emails from it, send an email to london-hack-space+unsubscribe@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.



Peter "Sci" Turpin

unread,
May 29, 2013, 3:59:20 PM5/29/13
to london-h...@googlegroups.com
New "equipment" page is now up on the wiki.

http://wiki.london.hackspace.org.uk/view/Equipment

The lists of equipment are *automatically generated* from the
information in their respective wiki page templates. Each is filtered by
main category (Equipment) and a secondary category.

Means this master list doesn't need updating manually anymore, just the
header text. As long as the piece of equipment's subcategory is one of
those set to display, it'll show up when it's added to the wiki or has
its details changed.

The template I made changes cell background colours to give a quick
visual overview of all the space's equipment.
Currently it's mostly dark red which indicates information is MISSING
from the pages. I don't know where everything is or what state it's in.
This requires actual checking. Please fill in the details if you can be
sure of them.

The page updates slowly so not to overload the server I believe. However
if you need to be sure, go to the EDIT page and hit preview, which will
force a check.

NOTES;
* The list is not comprehensive. We have more than 95 pieces of
equipment, therefore not all equipment has a wiki page. If you know
something is missing, please create a wiki page for it using the
unaltered template here:
http://wiki.london.hackspace.org.uk/view/Category:Equipment

* Some of the items listed may be inaccurate or no longer in use due to
the wiki pages for them having out of date information.

* The equipment page will probably need some categories hiding or moving
onto more specific pages (such as safety equipment listings on a
dedicated Health & Safety page). But for the moment it shows all the
basic categories I could break things down into without doing too much
micro-management.

* Please follow the template instructions. The display template doesn't
parse unexpected input very well. So;
** No username links, just names please.
** Describe locations, don't link. Have set output to link any text
there to the "Floor plans" page.

* There are some items that are actually duplicates or collections (EG,
the sewing machines). These really should be split into separate pages
eventually or the status message becomes less meaningful.

* It'd be good if each item had a photo so people could visually
recognise a piece of equipment. Someone go around with a camera?

* Query depth-limits mean I can't exclude enough categories to get an
"other subcategory" listing.

* Some common-names aren't transferring to the output lists. Not many,
but a few and I have no idea why. Might be a caching issue.

* Status messages are case-sensitive, so please just copy & paste the
right one from the template's hidden text. Did look into if a pull-down
menu was possible, but couldn't see any prior art for it for setting
infobox data from inside a page. Shame.

* Please don't delete unpopulated sections of the templates. They may
not be used at the moment, but will make it a pain for those that come
along and want to add the data later on.

* I transferred the old Equipment page to a /Legacy subpage so there's a
live reference to check what items without wiki pages might need creating.

* Yes, I also updated the header text a lot. Might want to check it's
all accurate & representative.

* Was sad to note 4 items of A/V equipment listed as missing (on
"Defunct" subpage)

I *think* that's it. Some categories, like A/V and Office Equipment are
a little dicey regarding content, but were the best fits I could think
of at the time. Wasn't going to get a thesaurus out. :P


TLDR; To make all the red go away, check the equipment and update it's
info. May take a few hours to register changes.

David Sullivan

unread,
May 29, 2013, 6:11:27 PM5/29/13
to london-h...@googlegroups.com
On Wednesday, 29 May 2013 20:59:20 UTC+1, Sci wrote:
New "equipment" page is now up on the wiki.

http://wiki.london.hackspace.org.uk/view/Equipment

The lists of equipment are *automatically generated* from the
information in their respective wiki page templates. Each is filtered by
main category (Equipment) and a secondary category.
...

The page updates slowly so not to overload the server I believe. However
if you need to be sure, go to the EDIT page and hit preview, which will
force a check.

If you're a wiki admin (which is easy enough to setup if you're a member) you can hit the "refresh" tab at the top of the Equipment page after you've made some changes.

Sully.
 

oliver greenaway

unread,
May 29, 2013, 7:11:40 PM5/29/13
to london-h...@googlegroups.com
Awesome, you made everything work on the Britannia lathe page i did! :D

Jasper Wallace

unread,
May 29, 2013, 9:05:02 PM5/29/13
to london-h...@googlegroups.com
On Wed, 29 May 2013, Peter "Sci" Turpin wrote:

> New "equipment" page is now up on the wiki.
>
> http://wiki.london.hackspace.org.uk/view/Equipment
>
> The lists of equipment are *automatically generated* from the information in
> their respective wiki page templates. Each is filtered by main category
> (Equipment) and a secondary category.

Thanks alot for doing this!

> Means this master list doesn't need updating manually anymore, just the header
> text. As long as the piece of equipment's subcategory is one of those set to
> display, it'll show up when it's added to the wiki or has its details changed.


> * Status messages are case-sensitive, so please just copy & paste the right
> one from the template's hidden text. Did look into if a pull-down menu was
> possible, but couldn't see any prior art for it for setting infobox data from
> inside a page. Shame.

Can we have 'Retired' and 'Unused' statuses as well? We've got some kit
that isn't being used for anything atm.

Or tell me where i'd go to edit that...

--
[http://pointless.net/] [0x2ECA0975]

Russ Garrett

unread,
May 30, 2013, 4:38:02 AM5/30/13
to London Hack Space
* My thinking with the locations was so that we could have pages for
the various areas listing specific details and showing photos (such as
http://wiki.london.hackspace.org.uk/view/Dusty_Wood_Shop which is now
broken). Personally I think that's more useful than a freeform text
field. I don't fully understand why you're using freeform text here
and insisting on specific formatting elsewhere.

* Why can't we link to user pages? Surely if you want to get in
contact with someone, that's where you'd look?

* In terms of unpopulated sections of the templates, my thinking was
to make it as easy as possible for people to add equipment. I think
Unknown/Unknown/Unknown looks ugly, and really most of these fields
should have defaults. This stuff is not going to get used if there's a
significant amount of hassle.

I have created a form for editing the EquipmentInfoBox template,
although the "Edit with Form" link isn't working on the equipment
pages for some reason. This seems like the more preferable way of
doing it:

http://wiki.london.hackspace.org.uk/view/Special:FormEdit/EquipmentInfobox/Equipment/VinylCutter

Unfortunately your comments in the template are now showing up on the form.

Russ
> --
> You received this message because you are subscribed to the Google Groups
> "London Hackspace" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to london-hack-sp...@googlegroups.com.
> For more options, visit https://groups.google.com/groups/opt_out.
>
>



--
Russ Garrett
ru...@garrett.co.uk

Alex Pounds

unread,
May 30, 2013, 4:42:35 AM5/30/13
to london-h...@googlegroups.com
On Wed, May 29, 2013 at 08:59:20PM +0100, Peter "Sci" Turpin wrote:
> New "equipment" page is now up on the wiki.
>
> * It'd be good if each item had a photo so people could visually
> recognise a piece of equipment. Someone go around with a camera?

I'm happy to take photos of the equipment & upload them to the wiki. I
won't be able to visit the space to do so until next week, though.

--
Alex Pounds
Web Developer & Photographer

http://alexpounds.com/ | http://ethicsgirls.com/

Russ Garrett

unread,
May 30, 2013, 5:01:43 AM5/30/13
to London Hack Space
On 30 May 2013 09:38, Russ Garrett <ru...@garrett.co.uk> wrote:
> I have created a form for editing the EquipmentInfoBox template,
> although the "Edit with Form" link isn't working on the equipment
> pages for some reason.

It works now (case sensitivity) - you can use "Edit with form" on
equipment pages to edit them in a nice way. This also means that you
don't need to fully-populate the template with "Unkkown"s as the form
will always show you which fields you can edit.

The form could do with some work (it itself is a wiki page...) but it
has combo boxes to restrict input on certain fields.

I've removed the example template from Category:Equipment and added a
field to create a page with the form.

--
Russ Garrett
ru...@garrett.co.uk

Peter "Sci" Turpin

unread,
May 30, 2013, 6:17:37 AM5/30/13
to london-h...@googlegroups.com
On 30/05/2013 09:38, Russ Garrett wrote:
> * My thinking with the locations was so that we could have pages for
> the various areas listing specific details and showing photos (such as
> http://wiki.london.hackspace.org.uk/view/Dusty_Wood_Shop which is now
> broken). Personally I think that's more useful than a freeform text
> field. I don't fully understand why you're using freeform text here
> and insisting on specific formatting elsewhere.
>
> * Why can't we link to user pages? Surely if you want to get in
> contact with someone, that's where you'd look?

I should have said in my notes; putting wiki-links of any sort
(particularly in combination with a comma-separated list of instances)
would cause the output template to treat them as empty feilds. I do not
know why, and did want them to contain links. Ultimately though I did
not have sufficient skill to track down the issue, so ran with the best
I could do.

Hopefully now the groundwork has been laid someone else can come in and
fix it so it parses all input correctly.

I suspect it will require parsing template input once to create a
plaintext list, then turn them back into links in the output template
due to the odd way the middleman Semantic seems to handle formatting
query results.

> * In terms of unpopulated sections of the templates, my thinking was
> to make it as easy as possible for people to add equipment. I think
> Unknown/Unknown/Unknown looks ugly, and really most of these fields
> should have defaults. This stuff is not going to get used if there's a
> significant amount of hassle.
>
> I have created a form for editing the EquipmentInfoBox template,
> although the "Edit with Form" link isn't working on the equipment
> pages for some reason. This seems like the more preferable way of
> doing it:
>
> http://wiki.london.hackspace.org.uk/view/Special:FormEdit/EquipmentInfobox/Equipment/VinylCutter

That's a much nicer way to do it indeed! If we can get a pull-down on
the status menu too, that would be good. We can throw in a link to each
page's edit-form in the the infobox template, and make status updating
even more trivial.
I know the status' are a little unhelpful regarding detail, so maybe I
need to add a status-comment too.

> Unfortunately your comments in the template are now showing up on the form.

Well if this form takes totally manual-editing out of the picture,
there's no harm in removing them.

Russ Garrett

unread,
May 30, 2013, 6:27:55 AM5/30/13
to London Hack Space
On 30 May 2013 11:17, Peter "Sci" Turpin <s...@sci-fi-fox.com> wrote:
> That's a much nicer way to do it indeed! If we can get a pull-down on the
> status menu too, that would be good.

That's done, it was just my mistake when creating the form. The source
for the form is here:

http://wiki.london.hackspace.org.uk/edit/Form:EquipmentInfobox

Syntax info here:

http://www.mediawiki.org/wiki/Extension:Semantic_Forms/Defining_forms

You can move your explanatory comments to there.

I'll have a look at the wiki links thing when I get a moment.

--
Russ Garrett
ru...@garrett.co.uk

Peter "Sci" Turpin

unread,
May 30, 2013, 7:21:17 AM5/30/13
to london-h...@googlegroups.com
If a piece of equipment has been retired though, we surely don't have it
anymore, so it'd be currently in sub-category "Defunct" and it's
functional status is irrelevant.

And without wanting to accuse, saying something isn't used has
historically tended to mean "I don't use this, so obviously no-one is".
Having it as a functional status will tie up perfectly functional tools
in bickering.

If we have something that isn't being used then it's taking up valuable
space, so bring it up on the mailing list and we'll see if it needs to
be disposed of. If it is disposed of, it'll become defunct. Until then
treat as the rest of the equipment. These are immediate "can I use this
right now?" status notes, not judgements of their functional value.

David Sullivan

unread,
May 30, 2013, 8:55:30 AM5/30/13
to london-h...@googlegroups.com
On Thursday, 30 May 2013 12:21:17 UTC+1, Sci wrote:

If a piece of equipment has been retired though, we surely don't have it
anymore, so it'd be currently in sub-category "Defunct" and it's
functional status is irrelevant.


Nope.

&

as one example. I've hidden the 1650A on the basement shelves as it has been superseded by the other and it's a very rarely used bit of kit but we do actually have it.

Sully.

Peter "Sci" Turpin

unread,
May 30, 2013, 8:00:14 PM5/30/13
to london-h...@googlegroups.com
So it's not so much unused, but held in reserve.

I still don't like the implication of "unused". Being labled so takes
things out of circulation conceptually.

If we need a status or class for these items, let it be "in storage". It
carries the same implication that it is unavailable to use, but more
specifically because it's immediately out for use, and less undefined
that it's not being used for no specific reason.

mentar

unread,
Jun 11, 2013, 7:13:28 AM6/11/13
to london-h...@googlegroups.com
Wow, Sci thanks so much for doing this.
I bow down to your wiki prowess and sheer persistence in sorting this
out as it must have taken ages!

This would be a good page to display on that google TV box we've got.

The only thing though isn't it better to use gray for missing data and
RED for "out of order"? That way if something is broken it's more likely
to get attention?

Thanks a lot, no really, thanks!

mentar
--
Mentar - Sent from my crApple free environment

Peter "Sci" Turpin

unread,
Jun 11, 2013, 8:01:05 AM6/11/13
to london-h...@googlegroups.com
Good point actually. Have changed some of the default displays colours
to grey. Not the location though, I feel that's important enough to keep
red. Afterall if we don't know where a tool is we can't even check up on
it. Hell, do we even still have it?

Not sure about having it on the googleTV. Like the idea of having it on
display, but as-is it'd be a fairly static page up on screen 24/7
needing manual refresh.
Maybe we could scrape the data and create a more concise to-do list for
pages with missing data, equipment checkups, etc and combine it with a
more general to-do list for the space?
Must confess though I'd love to see the googleTV displaying live
timetable info of all the local transport links with alerts for last
trains. Can we rig it in a split-screen sort of setup or automatic
desktop switching?

Mark Steward

unread,
Jun 11, 2013, 9:25:34 AM6/11/13
to london-h...@googlegroups.com
I'd like to put this on a Nook, but haven't had time to wade through the Android SDK. Has anyone already looked into replacing the screensaver with a custom carousel that updates periodically?


Mark


--
You received this message because you are subscribed to the Google Groups "London Hackspace" group.
To unsubscribe from this group and stop receiving emails from it, send an email to london-hack-space+unsubscribe@googlegroups.com.

tom

unread,
Jun 12, 2013, 4:15:42 AM6/12/13
to london-h...@googlegroups.com
why not disable the screensaver and just run it in chrome? 
To unsubscribe from this group and stop receiving emails from it, send an email to london-hack-sp...@googlegroups.com.

Mark Steward

unread,
Jun 12, 2013, 4:40:59 AM6/12/13
to london-h...@googlegroups.com

I would for something like train times, because it could then be interactive. But I'd quite like to see how long a slowly-updating display will run without power.

Reply all
Reply to author
Forward
0 new messages