The Linux Documentation Project: Manifesto

Last Revision: June 2008 Describes the goals, status, documentation conventions, and license requirements of the Linux Documentation Project.
Last Revision: June 2008
Describes the goals, status, documentation conventions, and license requirements of the Linux Documentation Project.
The goal of the Linux Documentation Project (LDP) is to create and distribute the canonical set of free GNU/Linux documentation. While GNU/Linux applications and utilities may come with their own documentation, LDP documentation fills in the numerous gaps.
The hundreds of existing LDP documents present both overviews and details of: the GNU/Linux Operating System, System Administration, Hardware, Networks, Servers, GUIs, Programming, Language Support, etc. Not every important topic is currently covered so LDP is seeking new authors to fill in the gaps.
An additional goal is to collaborate on all of the issues of GNU/Linux documentation. We hope to establish a system of documentation that is easy to use and search. This includes the integration of all available documents.
We freely distribute our documents via the Internet. Some major distributions of Linux include them on CDs. If you are interested in publishing any of the LDP works, see the section "Publishing LDP Documents" below.
The LDP is essentially a loose team of volunteers with minimal central organization. Anyone who would like to help is welcome to join in this effort. We feel that working together informally and discussing projects on our mailing lists is the best way to go. When we disagree on things, we try to reason with each other until we reach an informed consensus.
Currently, the major effort of the LDP is the writing of HOWTOs. If you think you would like to write a certain HOWTO first check to see if one already exists on your topic. If so, please subscribe to the LDP general discussion list at discuss@en.tldp.org or email feedback list and offer to help. If there is no HOWTO about it, you may want to create a new HOWTO. See the LDP Author Guide (formerly the HOWTO-HOWTO) and/or the HOWTO-INDEX for more details.
The "Guides" are large book-size LDP documents covering broad topics such as system administration.
Other tasks include checking the HOWTOs for clarity and errors, improving our website, and developing an integrated system of documentation for Linux. If you are interested in any such project (other than writing HOWTOs), subscribe to the LDP general discussion list at discuss@en.tldp.org.
The LDP has a number of mirror sites worldwide where one may inspect and/or download LDP documents. The main site is http://tldp.org. Go here to find the list of mirror sites and then use the nearest mirror site.
Here are the conventions that are currently used for LDP documents. If you are interested in writing another document using different conventions, please let us know of your plans first.
All HOWTO documents must be in one of these formats: LinuxDoc SGML or DocBook XML/SGML. LinuxDoc is the simplest DTD while DocBook is a more complex mark-up (with more features).
The guides -- full books produced by the LDP -- have historically been done in LaTeX, as their primary goal has been to be printed documentation. However, guide authors have been moving towards SGML with the DocBook DTD, because it allows them to create many different kinds of output, both printed and on-line.
Anyone may copy and distribute (sell or give away) LDP documents (or other LDP works) in any media and/or format. No fees are required to be paid to the authors. It is not required that the documents be modifiable, but it is encouraged.
You can come up with your own license terms that satisfy these conditions, or you can use a previously prepared license. The LDP has a boilerplate license that you can use if you wish. Some people like to use the GPL, while others write their own. There is a project underway to create a special GPL license just for documents and this may turn out to be a good choice ("The GNU Free Documentation License").
The copyright for each document should be in the name of the principal authors. "The Linux Documentation Project" isn't a formal entity and thus can't be used as a copyright owner.
Here is a sample copyright notice and "boilerplate" license you may want to use for your work:
Copyright (c) 2008 by John Doe (change to your name) Please freely copy and distribute (sell or give away) this document in any format. It's requested that corrections and/or comments be fowarded to the document maintainer. You may create a derivative work and distribute it provided that you: Send your derivative work (in the most suitable format such as sgml) to the LDP (Linux Documentation Project) or the like for posting on the Internet. If not the LDP, then let the LDP know where it is available. License the derivative work with this same license or use GPL. Include a copyright notice and at least a pointer to the license used. Give due credit to previous authors and major contributors. If you're considering making a derived work other than a translation, it's requested that you discuss your plans with the current maintainer.
Copyright (c) 2008 by John Doe (change to your name)
Please freely copy and distribute (sell or give away) this document in any format. It's requested that corrections and/or comments be fowarded to the document maintainer. You may create a derivative work and distribute it provided that you:
Send your derivative work (in the most suitable format such as sgml) to the LDP (Linux Documentation Project) or the like for posting on the Internet. If not the LDP, then let the LDP know where it is available.
License the derivative work with this same license or use GPL. Include a copyright notice and at least a pointer to the license used.
Give due credit to previous authors and major contributors.
If you're considering making a derived work other than a translation, it's requested that you discuss your plans with the current maintainer.
If you're a pu