[TriLUG] TLDP

[William Sutton]

I've only spent 30 seconds browsing it and it looks like it's a decade out 
of date (other than the mirror info note, which is 2 years out of date and 
the apparently auto-generated date in the upper-right corner of the page, 
which appears to be current locale date).

IMHO, the site needs to be sent to its grave.

--

With regard to Peter's remarks,
1. from what I can tell, TFM in this case is supposed to be mainly man 
pages and howtos, which should be more up to date than source code (at 
least, the man pages that come with your average installation should be 
expected to cover the current state of the commands available).
2. I frequently find TFM (WRT userspace and admin commands) to be highly 
useful and informative, especially when I can search online man pages.
3. WRT howtos, I find the Gentoo and Arch forums to have better and more 
up-to-date content than most stock howto pages.

--

As a final aside (and as a software (Perl) developer-turned-sysadmin), I 
believe that people who maintain source code and provide documentation 
with it ought to provide current documentation.  For all my frequent snide 
remarks about Java, at the very least, javadoc should provide a current 
snapshot of the package methods available and their arguments.  Anyone 
else who takes any sort of pride in their work should do so as well, and 
anyone who doesn't take enough pride in their work should be encouraged to 
do so (on a sliding scale from "here, I've updated your docs for you" to a 
Linus Torvalds to Kay Sievers dressing down).

William Sutton

On Sun, 4 Jan 2015, Peter Neilson wrote:

> On Sun, 04 Jan 2015 04:28:37 -0500, Jason Evans <jsevans at youvegotthe.info> 
> wrote:
>
>> Does anyone know if The Linux Documentation Project (tldp.org) is still 
>> an active project?  Most of the documentation there is years old and out 
>> of date.  I'd like to join an open source project. add get some more 
>> experience writing documentation. Anyone here work with or for them in 
>> the past? If they are not really active, do you have any suggestions on 
>> where I can go to volunteer?
>
> Who uses it, and for what purpose?
>
> Is the project write-only storage by default? In other words if nobody 
> uses it, then there is no point in fixing it.
>
> I'd not even heard of it before, and as of now have spent less than a 
> minute examining the website.
>
> There is a theory that for development purposes "RTFM" is a bad idea, 
> because TFM is always out of date, and RTFSC is the only rational 
> approach. Purists presumably read source code from which the comments have 
> been stripped. We won't discuss those who read a.out files.
> -- 
> This message was sent to: William <william at trilug.org>
> To unsubscribe, send a blank message to trilug-leave at trilug.org from that 
> address.
> TriLUG mailing list : http://www.trilug.org/mailman/listinfo/trilug
> Unsubscribe or edit options on the web	: 
> http://www.trilug.org/mailman/options/trilug/william%40trilug.org
> Welcome to TriLUG: http://trilug.org/welcome