Loomio

Wiki Cleanup

ST Sean Tilley Public Seen by 16

Much work has gone into our documentation, and with the migration over to wiki.diasporafoundation.org, we can now focus on clearing up any duplicates of our docs.

G

goob Mon 1 Jul 2013 2:50PM

I'd been thinking about that as well, Jonne. As an ex-editor, it was irritating me. My personal preference is strongly for capitalisation of the first word only, i.e. from your examples, 'How we communicate'. Lots of capitals are ugly on the eye and tend to jerk the flow of reading. (Of course, words such as Diaspora would always take a capital.)

I didn't want to start changing things however as it was my opinion, but it would be good to have an agreed standard. Whether we need a vote or not, I'm not sure - let's see if we can get agreement on one form without it.

I'm for capital on the first word only - who agrees? Who disagrees?

I could try to dig up or produce a draft 'house style' which could be put on the wiki so that prospective editors could check it so they know how we want things styled in general.

JH

Jonne Haß Mon 1 Jul 2013 6:29PM

If you could make a draft under http://wiki.diasporafoundation.org/Diaspora_Wiki:Article_naming_guidelines so we have something more concrete to discuss/agree about that would be awesome IMO. As said I've no preference personally, that is a small tendency to first cap, else lowercase with exceptions like Diaspora, but all I really want is consistency.

G

goob Tue 2 Jul 2013 2:12PM

I've made a draft under http://wiki.diasporafoundation.org/Diaspora_Wiki:Article_naming_guidelines (didn't notice the "Diaspora Wiki" in the article title until it was too late....)

I've tried to be as general as I can and also as brief as I can, covering the main points of variance which crop up in articles while not being too prescriptive.

Please note that at this stage my suggestions are simply my suggestions, based on what I think may be most helpful and require the least number of changes to existing articles. If there are objections to what I have suggested, that's fine, and we can discuss what others feel would be best for the wiki.

Hope it's useful.

JH

Jonne Haß Tue 2 Jul 2013 4:36PM

Uhm, I only see http://wiki.diasporafoundation.org/Diaspora_Wiki:Wiki_style_guidelines but given the content that's fine ;) The namespace casing is fine too I think, that was MediaWikis default iirc.

I like it and can agree with it, except for the Diaspora* rule, I think that becomes a bit annoying and disrupts the reading flow over time. It also creates an inconsistency since we don't want that in the page titles.

G

goob Tue 2 Jul 2013 4:58PM

Sorry, I pasted the wrong link! Yes, I saved it as Wiki_style_guidelines as it had a broader remit than simply article titles.

I take your point with Diaspora*, was really raising that as a question as I'd like to know others' views on it, and it would be good to have a consistency there. I've tried to use the asterisk when writing as I felt I should, but like you I feel it can get annoying when there's lots of text, so would be happy to drop it (except perhaps in certain circumstances).

Look forward to other comments and corrections.

G

goob Wed 10 Jul 2013 3:34PM

I have just added a draft guide to choosing a pod to the Community supported pods page. Would be grateful if others would look at it and make additions, corrections, amendments and edits. Once we're all happy with it, I suggest replacing the old 'Community supported pods' text and list of pods with this guide, as it will be of more use, and is in part a guide to how to use Pod Uptime, which is a more useful tool than a static list of pods, which is what the 'Community supported pods' page is.

cheers
Goob

JH

Jonne Haß Fri 19 Jul 2013 6:09PM

Okay, enough time for voicing objections passed, I don't think we need a vote on that, so I'm removing the draft status from https://wiki.diasporafoundation.org/Diaspora_Wiki:Wiki_style_guidelines and start moving the pages.

G

goob Fri 19 Jul 2013 8:05PM

When you say 'moving pages', do you mean changing the titles to lower case, and if so is that done by creating a new page with the correctly cased title and deleting the old one? If so I'll try to help with this.

If it's something different that I can help with, let me know what is needed.

Is there a list somewhere of all pages on the wiki so I can easily see which need changing?

JH

Jonne Haß Sat 20 Jul 2013 3:49PM

@goob Wiki administrators have a move function which largely automates the process ;) https://wiki.diasporafoundation.org/index.php?title=Special%3AAllPages&from=&to=&namespace=0&hideredirects=1 Did I miss anything?

G

goob Sat 20 Jul 2013 4:08PM

Fantastic!

The only two I can see with capitalisation are Federation Restructuring Proposal and Main Page, although it might be that the latter needs that capitalisation to act as an index page within MediaWiki's workings.

Thanks for doing all that. Glad that you could automate it.