There are many open source projects which exist not only for years, but also for decades (which e.g. NetBSD also nearly does with 19 years). For all of them, documentation is an important issue, and most, if not all projects have not mastered writing documentation.
In this task, you have to choose on of the projects listed below. If you want to research another project not listed, please ask a judge about it.
Then, you have to research the documentation of these projects (what sources are there, how are they used, which software do they use, which formatting language, etc. (what sources are there, how are they used, which software do they use, which formatting language, etc.), plus finding a way of determining the project's opinion of their documentation (a docs@ mailinglist might be a good start, like e.g. NetBSD-docs@NetBSD.org is). All in all, you should do nearly the same as the task "Create an overview of NetBSD documentation", except that you don't have to be that much in depth, but you should also research the technical and administrational background.
In the end, you should write a paper with the results of the survey and a small text, at least one page at all.
This task can be fulfilled multiple times, once for each project. It will be recreated once it's claimed.
Possible projects: Debian, FreeBSD, OpenBSD, DragonFly, Gentoo, Arch Linux, Slackware, PostgreSQL
| File name/URL | File size | Date submitted | |
|---|---|---|---|
| Documentation Structure.txt | 2.6 KB | January 04 2013 22:08 UTC | |
| Documentation Structure.txt | 3.7 KB | January 05 2013 07:40 UTC |
Hey julian , I Would Like To Claim This Task
I would like to work on this task.
This task has been assigned to Shayantan. You have 72 hours to complete this task, good luck!
Hey . I Need Help On The Task . Should I Download One Of The Operating Systems given below ?
The claim on this task has been removed, someone else can claim it now.
I would like to work on this task.
I am interested in researching the documentation structure of FreeBSD
FreeBSD is a good project for this.
But you have to be careful, as FreeBSD has many places for its documentation, partially in two places.
This task has been assigned to Vijay Nandwani. You have 72 hours to complete this task, good luck!
Thank you for assigning me the task.
I have one question. What does the following line in the description means?
plus finding a way of determining the project's opinion of their documentation (a docs@ mailinglist might be a good start, like e.g. NetBSD-docs@NetBSD.org is)
Does the project here refer to the project which we are researching for or something else.
I have submitted a file with all the information. If the file requires some more information or needs some editing, please inform me.
Thank you :)
The work on this task is ready to be reviewed.
This is already a good start, but please provide more information about what the single documentation platforms really document.
Please say more for what kind of information the wiki is used, and when the SGML documentation, and when the manpages.
One of the mentors has sent this task back for more work. Talk to the mentor(s) assigned to this task to satisfy the requirements needed to complete this task, submit your work again and mark the task as complete once you re-submit your work.
The work on this task is ready to be reviewed.
Thank you for your submission, this is exactly the kind of work we expected.
As you did this task in very a good manner, maybe you want to do this with further projects (esp. Arch Linux would be interesting imho)? I recreated this task if you want to do it a second time: http://www.google-melange.com/gci/task/view/google/gci2012/8202203
Congratulations, this task has been completed successfully.
Thanks a lot Julian Fagir! My current task is ready, I just need to submit that. After that I'll definately try to do another task of this kind.
Thank you :)