Gentoo Archives: gentoo-dev

From: Joshua Saddler <nightmorph@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] Is Gentoo dying?
Date: Sun, 04 Apr 2010 10:08:18
Message-Id: 20100404030755.409290d2@angelstorm
In Reply to: Re: [gentoo-dev] Is Gentoo dying? by Tobias Scherbaum
1 On Sun, 4 Apr 2010 10:22:06 +0200
2 "Tobias Scherbaum" <dertobi123@g.o> wrote:
4 > 5 years ago [...] constantly added [...]
6 You need to clarify your metric. How are you defining constant? How often does a new document need to appear?
8 What mostly happens is steady refinement and expansion of our existing docs, occasionally splitting off long portions into their own document, or merging a few back together where appropriate.
10 Stuff that's written fully from scratch is much rarer than you think, and it's been that way for a long time. I'm not saying that's a bad thing; that's just how it is.
12 Two noteworthy exceptions: 2005 and 2006. Those were years when we had all the English speaking GDP members writing. I came on board in 2005 and immediately helped crank out docs and updates, and worked with folks to get new stuff into the tree. 2005 was a good year both for the GDP and for external contributors to help write stuff and add patches, which is why we saw much more diversity in our new docs.
14 Since then, the list of active English writers in the GDP has declined to one and it's been that way for a few years now, so that partly explains the slowdown in docs. Another is that we just aren't getting as many new submissions since the days when (apparently) we had more willing developers to pitch in with the docs.
16 Many of the 2005/2006 guides have had their primary authors/contributors disappear, leaving us without an easy way to keep them up-to-date. The GDP can't maintain a doc if we don't have someone, internal or external, who can devote time to keeping docs up-to-date. Lots of those 2005/2006 additions need serious overhaul, or I'll have to mark 'em deprecated/draft or even remove them entirely.
18 Some of the guides written years ago have been removed from the tree. Part of maintaining documents is not just writing new ones, but treecleaning, if you will, our existing collection. It's not as attention-getting as a totally new guide. I can't promise attention-getting news releases for every doc or website change I make.
20 * * *
22 Here, I'll take 2 hours to go through our complete CVS history for our docs in /doc/en/ and create a list of what was added or removed in the last 5 years.
24 This list doesn't *begin* to include total rewrites or near-total rewrites (such as the printing, gnome, X11 guides) or whether the rewrites were made in just one day or over time as packages and methods have evolved. It doesn't cover the handbooks, nor the handbooks I wrote entirely from scratch in 2006 to cover the new GLI installers (and their subsequent removal after 2008's releases).
26 It also does not include documents that have since been marked "draft" or "deprecated" or some other maintainance status besides "active." I expect some of the docs on this list to still be in "draft" or to have moved to it or "deprecated," so whether they really count is up to you to decide. If you want to average docs on a monthly or yearly basis . . . you can tweak the numbers all you want.
28 Note, also, that just because you don't see a doc on it in the last 5 years doesn't mean we don't already have a wealth of published info on a subject in our existing documentation. Something that was added in, say, 2002 or 2004 is prolly very complete, and covers lots of stuff you'd normally find in separate articles elsewhere, for example on wikis. I'm not putting much here besides the files added/removed.
30 This is just stuff that's initially added to or removed from CVS.
32 *2010*
34 Nothing totally new added nor anything completely removed. Hey, the year is young. Lots of rewrites though.
37 *2009*
39 Same. Mostly extensive rewrites, most notably the handbooks to take into account the autobuilds.
41 New: bind-guide.xml
42 New: lxde-howto.xml
43 New: openbox.xml
44 Removed: ldapdns-guide.xml (added 2006)
45 Removed: gentoo-sparc-quickinstall.xml (added 2004)
47 *2008*
49 New: multipath.xml
50 New: nagios-guide.xml (draft)
51 New: openrc-migration.xml
52 Removed: apache-developer.xml (added 2005)
53 Removed: apache-troubleshooting.xml (added 2005)
54 Removed: apache-upgrading.xml (added 2005)
55 Removed: kde-config.xml (added 2004)
56 Removed: kde-split-ebuilds (added 2005)
58 *2007*
60 New: gcc-optimization.xml
61 New: pda-guide.xml (draft)
62 New: vpnc-howto.xml
63 New: xen-guide.xml
64 New: xfce-config.xml
65 Removed: colinux-howto.xml (added 2004)
66 Removed: mysql-upgrade-slotted (added 2006, but mysql team reverted SLOTting)
67 Removed: nx-guide.xml (added 2004)
68 Removed: openmosix-howto.xml (added 2003)
70 *2006*
72 New: change-chost.xml
73 New: conky-howto.xml
74 New: cross-compiling-distcc.xml
75 New: gentoo-alpha-faq.xml
76 New: gentoo-x86+raid+lvm2-quickinstall.xml
77 New: info-guide.xml
78 New: jffnms.xml
79 New: kernel-config.xml
80 New: ldapdns-guide.xml (removed 2009)
81 New: liveusb.xml
82 New: man-guide.xml
83 New: portage-utils.xml
84 New: postgres-howto.xml
85 New: vdr-guide.xml
86 New: zsh.xml
87 Removed: java-old.xml (added 2006)
88 Removed: vserver-howto.xml (added 2005)
90 *2005*
92 New: apache-developer.xml (removed 2008)
93 New: apache-troubleshooting.xml (removed 2008)
94 New: apache-upgrading.xml (removed 2008)
95 New: bluetooth-guide.xml (deprecated; needs total rewrite)
96 New: bugzilla-howto.xml
97 New: fluxbox-config.xml
98 New: gcc-upgrading.xml (imported from toolchain /proj/ doc)
99 New: gentoo-amd64-faq.xml
100 New: gentoo-freebsd.xml (deprecated; needs total rewrite)
101 New: gentoo-mips-faq.xml
102 New: gpm.xml
103 New: grub-error-guide.xml
104 New: hpc-howto (imported from cluster /proj/ doc)
105 New: mailfilter-guide.xml
106 New: mysql-howto.xml
107 New: mysql-upgrading.xml
108 New: sudo-guide.xml
109 New: usb-guide.xml
110 New: utf-8.xml
111 New: vserver-howto.xml (removed 2006)
112 Removed: macos-guide.xml (added 2004)
113 Removed: gentoo-alpha-compaq-tools.xml (added 2003)
114 Removed: 2.6-koutput.xml (added 2004)
115 Removed: 2.6-koutput-user.xml (added 2004)
116 Removed: gentoo-security.xml (added 2002)
117 Removed: modular-x-howto.xml (added 2005)


File name MIME type
signature.asc application/pgp-signature