Efforts to Clean Wiki

Hi All,

I'm just curious if documentation team is doing anything to clean the wiki. There are so many pages that are either dupes and/or poorly written (including a few by me :frowning: ) that I think might fall into Documentation land.

Just curious as your thoughts. Not trying to tell you guys to do it :wink: Just thinking if you have the people (which I think you do...I see requests for ODFAuthors coming through all the time) then maybe that can be an additional project outside of just cleaning and translating the manuals.

Thinking out loud - please don't get irritated if I'm off base :slight_smile:

Best,
Joel

I'm just curious if documentation team is doing anything to clean the wiki.

Probably not.

There are so many pages that are either dupes and/or poorly written

On the face of it, that sounds like an "easy hack".
However, for somebody just starting out with documentation, it looks
like a daunting task.

Breaking it up into five or six tasks would make it look much less
daunting, and more appropriate for an "easy hack":
* Duplicate page;
* Badly written material;
* Outdated material;
* Material on this page conflict with material on another page;
* Good but not current material;
* Both good and current material;

Then once those determinations had been made, material can be
re-written, updated, etc.

jonathon

Sounds good - interested in helping to coordinate that :slight_smile: I'll help but I can't be in a 100 places at once :-D.

Also - is there any interest of getting a IRC channel together for documentation? It's been quite awesome for QA (and devs of course). Let me know if there's interest there and I'll get one set up.

~Joel

Sounds good - interested in helping to coordinate that :slight_smile:

I'm not part of the documentation project.
(For reasons I won't go into, it is best for me not to be a formal
member of any group, regardless of how casual said group is.)

is there any interest of getting a IRC channel together for documentation?

What would the function/purpose of the channel be?
How would it integrate into the existing work-flow?

Maybe provide examples of how dev and QA use it.

jonathon

After thinking about this for a week or so.

I don't know what the capabilities of the CMS that the wiki uses.

If a notice-template that automatically places the page into a specific
category can be created, then one for each category (Duplicate page,
badly written, outdated, conflicts with, good but not current, good and
current, any other categories needed to clean up pages), be made.
I can walk through the wiki, placing the appropriate notice-template on
the talk page.

Then the "easy hack" for somebody starting out with documentation is ready.

I don't have the disk space to pull the entire wiki onto my laptop, and
throw my tools at it, to determine which pages fall into which categories.

jonathon

That's fine - others have volunteered.

How much disk space would it take?

There is absolutely no need to download the wiki....that goes well beyond what I had in mind....

Best,
Joel