Updating and refreshing Edubuntu documentation

Registered by Vikram Dhillon

The current state of documentation as stated by highvoltage is pretty bad, a lot still just points to hardy, so we need to refresh it and find an efficient way of getting and updating more info. (quite possibly automatic like sru) and correctly obtaining and using user-input. Some of these goals might seem far-fetched but we can accomplish them over the time of if not 1, 2 release cycles. Here are some of the steps that we could take:

1. I know some people over at google, and we can use a script used made by Phil that analyzes what people are asking over IRC channels, and we can also give some keywords to the specific software/package we care for. Phil's script is in one of my branches :) and from google, if we ask them on behalf of edubuntu-community I am pretty sure they would let us use some analytics :) From that information we can better focus on what the user needs.

2. Documentation is good if we keep it updated, we need to play around with yelp and implement some features with the same idea as rss so we can direct/send new information painlessly which would be sort of like a patch but will also help keep the docs. updated from time to time.

3. The most important one, we NEED a online system like google sidewiki where users can go and comment on what they liked on the page they were reading, or something rather inside yelp again that users can use to send through comments, google's sidewiki has an awesome spam protection algorithm that we can also use. This connects us directly to the users and combined with step one we can see what the users are looking for the most and send them this information.

4. A last step would be to write a script that automatically convert wiki pages to docbook markup, something like that already exists in gnome, I remember seeing an email conversation on that topic so I'll pull that script and see how we can use it here

All this sound nice but its pretty tricky to implement. But then again, to achieve something you've never had before, do something you never did before :) I'll put it a lot of my time into this and see how we can split this up if others show interest as well.

Blueprint information

Status:
Complete
Approver:
Jonathan Carter
Priority:
Undefined
Drafter:
Vikram Dhillon
Direction:
Needs approval
Assignee:
Vikram Dhillon
Definition:
Obsolete
Series goal:
None
Implementation:
Unknown
Milestone target:
None
Completed by
Vikram Dhillon

Related branches

Sprints

Whiteboard

* Present this to edubuntu developers
* Extend this to translations as well
* See how the web-development and drupal teams can help :)

(?)

Work Items

This blueprint contains Public information 
Everyone can see this information.