Inside TLDP

A behind-the-scenes look at the evolution of the Linux Documentation Project.
New Procedures

But all these efforts were not enough. Ever more authors and other volunteers needed guidance, and ever more documents had to be organized. The project hosted a lot of outdated documents by now, which became a bit shameful. Another problem was the random publication of documents. There was so much work and not enough people to do it, so anybody could publish almost anything. Scandal broke loose when a couple of opinionated documents were found, containing tainted and sometimes plainly wrong information that was possibly harmful to the readers.

Thus, 2003 became the year of revamping. A thorough search through the entire collection revealed more old or doubtful documents that were taken off-line for a revision. Documents too old to be useful were moved to the attic. Tabatha Marshall was appointed review coordinator and put together a team of reviewers. Together, they edit new submissions: they check for technical correctness, readability and grammar and spelling errors. Furthermore, they apply the TLDP style so as to give the collection consistency. The Weekly News was revived and offered over RSS feed. Input from the feedback mailing list was followed up once more. The Author Guide was revised to list the new procedures for publishing documents in accordance with the quality control guidelines. A HOWTO generator was created to facilitate submissions by new authors. Beyond these visible accomplishments, hundreds of people are working together now, everyone of them contributing a small part to this huge project.

People responsible for managing projects often ask us how we do it. This is how. There is no book that tells you how to do it. We are on a road with many bumps and ups and downs, and TLDP seemingly hangs together with hooks and eyes--but it's there and it doesn't go away.

______________________

Comments

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.

People responsible for

poker online's picture

People responsible for managing projects often ask us how we do it. This is how. There is no book that tells you how to do it. We are on a road with many bumps and ups and downs, and TLDP seemingly hangs together with hooks and eyes--but it's there and it doesn't go away.

Regards,
Negoita

thank you

Free online dating site's picture

Thank you for this project. My website livedatesearch.com is developed in pure C++ for Linux, it does not use any MySQL/PHP databases. All database is held in RAM with STL and dumps at disk. TLDP has greatly helped me to create it. Thank you!

2004 ... wow this is some

Anonymous's picture

2004 ... wow this is some kind of historic document right here ;)
greets, Leupold Luftreiniger

awesome

leo12's picture

Thank you for taking the chance to deliver this affair. I’m pleased I discovered your site on this material. I’m doing research on this interest right now and this was great. Keep up the great work.I’m doing research on this interest right now and this was great. Keep up the great work. weight loss fast

Thank you

adtech's picture

Thank you

awsome

leo12's picture

I am so glad that I have found this your article because I have been searching for some information about various recipes from pig meat almost an hour. You helped me a lot indeed and reading this your entry I have found many new and useful information about this question. Well, I will definitely bookmark your website and wait for other useful and detailed posts like this one in the future. email marketing

TLDP down?

Henning Sprang's picture

What happened to the TLDP?

Since weeks, I only get Server timeouts ("Firefox can't find the server at www.tldp.org.") when trying to access the tldp.

What's up with it?

Henning

Inside TLDP: setting things straight

Anonymous's picture

- According to an excerpt from the ldp-l@linux.org.au mailinglist archive that was sent to me, Guylhem took over from Lars only in 1999.

- There are a couple of things left out, since this is an article and not a book:
* Rise and fall of the Open Source Writers Group;
* David Merrill, creator and maintainer of the LDP database and developer of LDP tools, deserves credit but is not mentioned - but on the other hand there are many others who did fantastic work and are not mentioned here. I hope these people understand the context of this article and know that I am thinking about them, eventhough they are not all listed by name;

- Note the difference between old documents that are unmaintained and documents that deal with old(er) concepts or old hardware but that are still being maintained;

- I might have given the impression that Guylhem took over a floundering organization, but this is not so. Lars, his predecessor, was working on major changes, including an automated submission system for updates - however this was never finished;

- Not all printed copies of TLDP docs were copies of the complete collection.

Tille.

Re: Inside TLDP: setting things straight

Anonymous's picture

The historical record of the "core team" has been preserved AND the current structure is available from: http://tldp.org/vlist.html

emma

Thanks

Anonymous's picture

The LDP has been a valuable resource to many, despte the issues with outdated documents you mentioned. Thanks for all your time and effort on the project.

old documents and tldp in general

Anonymous's picture

Hi.

The TLDP is actively working on improving its collection and removing anything old and redundant.

But for this kind of thing we need help, volunteer work doesn't happen by itself.

So if anyone finds spare time feel free to contribute to the TLDP....

regards,
current ltdp contributor

TLDP

Bruce Byford's picture

I just contributed to TLDP about 2 weeks ago but haven't received an acknowledgment yet. Could you please look into it?

Bruce
Business Directory

White Paper
Linux Management with Red Hat Satellite: Measuring Business Impact and ROI

Linux has become a key foundation for supporting today's rapidly growing IT environments. Linux is being used to deploy business applications and databases, trading on its reputation as a low-cost operating environment. For many IT organizations, Linux is a mainstay for deploying Web servers and has evolved from handling basic file, print, and utility workloads to running mission-critical applications and databases, physically, virtually, and in the cloud. As Linux grows in importance in terms of value to the business, managing Linux environments to high standards of service quality — availability, security, and performance — becomes an essential requirement for business success.

Learn More

Sponsored by Red Hat

White Paper
Private PaaS for the Agile Enterprise

If you already use virtualized infrastructure, you are well on your way to leveraging the power of the cloud. Virtualization offers the promise of limitless resources, but how do you manage that scalability when your DevOps team doesn’t scale? In today’s hypercompetitive markets, fast results can make a difference between leading the pack vs. obsolescence. Organizations need more benefits from cloud computing than just raw resources. They need agility, flexibility, convenience, ROI, and control.

Stackato private Platform-as-a-Service technology from ActiveState extends your private cloud infrastructure by creating a private PaaS to provide on-demand availability, flexibility, control, and ultimately, faster time-to-market for your enterprise.

Learn More

Sponsored by ActiveState