DocumentationTeam
|
Size: 3246
Comment: some minor edits, formatting tidied
|
Size: 2067
Comment: complete rewrite
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = DocumentationTeam = | = Introduction = |
| Line 3: | Line 3: |
| The documentation team is the engine of the Ubuntu Documentation Project (UDP), an Open Source volunteer project that aims to develop and maintain literary content surrounding the Ubuntu distribution and community. The DocumentationTeam is responsible for the books you can find in the Help section of your Ubuntu distribution. | The Documentation Team manages the Ubuntu Documentation Project (UDP), an open source volunteer project that develops and maintains documentation for the Ubuntu operating system. |
| Line 5: | Line 5: |
| Authored works are released using a dual license strategy. This means there are many ways to contribute to the project - documenting, editing, proof reading, technical checks and reporting or fixing typos, grammar or spelling errors. Even suggestions or ideas are welcomed here. |
The docteam is still very small, and has a big job to do. New contributors and members are always welcome. People are needed mostly for writing and editing, but there are many other ways of making a useful contribution. For example, simply pointing out errors (such as typos, grammar and spelling, and technical errors) is an extremely useful way to help. |
| Line 8: | Line 7: |
| FAQ about the ubuntu documentation efforts can be found at the DocumentationTeamFAQ wiki page. | = How to Contribute = |
| Line 10: | Line 9: |
| == Getting Involved == | Great! You want to help. |
| Line 12: | Line 11: |
| Great! You want to help. Here is a list of links to resources that will provide information on how to get started and become a productive member of the team. | '''Don't worry if you don't know any of our tools yet.''' You can make useful contributions before learning how to use the tools. The easiest way to help is to take a look at our current works in progress on the DocteamProjects wiki page. DocteamProjects contains links to HTML previews of our work. The previews are updated regularly, and in most cases will only be a day or so out of date. When you find errors in these documents, point them out to us either on IRC on the [:DocteamCommunications:#ubuntu-doc channel], or on our [:DocteamCommunications:mailing list]. If you write a section for us, then send it to the mailing list. We will review your changes and additions, implement them, and give positive feedback. |
| Line 14: | Line 13: |
| If you are in a hurry, we suggest reading "ForTheHasty." This page is the project nuts and bolts in a nut shell. We highly recommend it to people with experience in Open Source documentation projects. | You can also work directly on the Doc''''''Book sources. Read-only access to the docteam's repository is available at https://docteam.ubuntu.com/repos. Once you have emailed a few patches to the mailing list, you will be given an account with direct read-write access to the repository. |
| Line 16: | Line 15: |
| For the not so hasty we recommend the scenic tour. The scenic tour is a list of links to pages arranged in an order that will guide you through various steps and provide you with information such as - where to find things, what you need, what needs doing, what's being done, what has been done, and how to do them. Each of these topics is linked to the next in sequential order. * DocteamGettingStarted - What we do and how to get involved. |
= Important Links = * DocteamGettingStarted - An introduction to the tools and procedures we use. * DocteamProjects - A list of everything under development. Includes links to status pages and HTML previews. |
| Line 21: | Line 19: |
| * DocteamProjects - The documents we work on: a list of everything under development linked to document specifications, HTML previews and status informations. * DocteamWork - Programs and technologies. A descriptive list of the tools and technologies used in the project with links to relevant information. * DocteamServices - Collaborative community infrastructures. Information about the nature and purpose of the various networks services that facilitate our communications. == Special Help Wanted Here == We can't all be experts. From time-to-time we need special skills not current within our skill pool and would be happy to obtain extra help. If there is something listed here and you feel that you can help, we would be happy to hear from you. '''Help with the Following Books'''! There are still a number of book projects that need community support! The status of these books and the other DocumentationTeam Projects are located at the DocteamProjects page. Eveyone interested is invited to dive in and check out the projects. Current members of the DocumentationTeam will be updating this page to regularly inform the community on the status of the projects. ## * Ubuntu/Kubuntu Installation Guide ## * Ubuntu User Guide ## * Kubuntu Quick Guide ## * Ubuntu/Kubuntu FAQ Guide To contribute new content without needing to mess with subversion or docbook, one can just post them to the ubuntu-doc list. ##, or add/link their new parts ##at the end of QuickGuide and annonce them to the ubuntu-doc list, |
* DocteamCommunications - Our methods of communication. (Internet Relay Chat and mailing lists) |
| Line 44: | Line 21: |
| CategoryDocteam CategoryUbuntuTeams | CategoryDocteam CategoryUbuntuTeams |
Introduction
The Documentation Team manages the Ubuntu Documentation Project (UDP), an open source volunteer project that develops and maintains documentation for the Ubuntu operating system.
The docteam is still very small, and has a big job to do. New contributors and members are always welcome. People are needed mostly for writing and editing, but there are many other ways of making a useful contribution. For example, simply pointing out errors (such as typos, grammar and spelling, and technical errors) is an extremely useful way to help.
How to Contribute
Great! You want to help.
Don't worry if you don't know any of our tools yet. You can make useful contributions before learning how to use the tools. The easiest way to help is to take a look at our current works in progress on the DocteamProjects wiki page. DocteamProjects contains links to HTML previews of our work. The previews are updated regularly, and in most cases will only be a day or so out of date. When you find errors in these documents, point them out to us either on IRC on the [:DocteamCommunications:#ubuntu-doc channel], or on our [:DocteamCommunications:mailing list]. If you write a section for us, then send it to the mailing list. We will review your changes and additions, implement them, and give positive feedback.
You can also work directly on the DocBook sources. Read-only access to the docteam's repository is available at https://docteam.ubuntu.com/repos. Once you have emailed a few patches to the mailing list, you will be given an account with direct read-write access to the repository.
Important Links
DocteamGettingStarted - An introduction to the tools and procedures we use.
DocteamProjects - A list of everything under development. Includes links to status pages and HTML previews.
DocteamLicense - The license used for the documentation produced by the team.
DocteamCommunications - Our methods of communication. (Internet Relay Chat and mailing lists)
DocumentationTeam (last edited 2021-06-11 05:29:18 by roguescholar)