Gentoo Archives: gentoo-doc

From: "Jan Kundrát" <jkt@g.o>
To: gentoo-doc@l.g.o
Cc: Theo Chatzimichos <tampakrap@g.o>, dberkholz@g.o
Subject: [gentoo-doc] okupy, a Django rewrite of www.g.o
Date: Thu, 02 Jun 2011 10:14:08
yesterday I read Theo's blog post [1] about his upcoming GSoC project,
which apparently is about using Django for www.g.o, and has some
implications for the way how the GDP works.

I have a few comments/notes that I want to say here. They reflect my
personal opinion, which is based on six years of working with docs. I
have no idea whether they match the opinion of the rest of the GDP.

First of all, a suggestion -- maybe, when you want to do something to
the docs (like change the presentation layer, integrate a WYSIWYG
editor, convert to git from CVS, or stuff like that -- which are all the
objectives of the project [2]), maybe it would be a great idea to
contact the GDP first. There are fine contacts for chatting with us,
either the nice gentoo-doc ML, or the #gentoo-doc IRC channel, or the
docs-team@g.o alias. I have no idea whether Theo contacted anyone
directly, but I'm sure I haven't received anything through any of these
channels. That's bad, and it means that there's a communication problem

The project description speaks about a perceived problem with editing
the GuideXML files. This issue has been raised many times. My impression
is that people failed to support that assertion with anything
substantial; the people who argue that "there should be something" are
typically not doing much GDP work. That impression might be flawed, of

Theo also mentions that "By all appearances Gorg has been abandoned as a
project. This has resulted in difficulty in maintaining the Gentoo
website, and also makes the work of updating the website's design or
functionality all the more troublesome." and goes on to mention that
"Gorg as an abandoned project is suffering from bugs that get pilled up,
not to mention possible security risks that may arise". Can I ask for a
reference to the "bugs that get pilled up", and to Gorg resulting in
"difficulty in maintaining the Gentoo website"?

Please don't get me wrong, I certainly do not want to hinder any efforts
targeted at making our website better, or our workflow faster for those
that really contribute. I just tend to get slightly upset when I see an
approved GSoC project which will, IMHO, fundamentally change the way how
GDP works, then read a few assertions that fail to persuade me, and
realize that I can't find any notice of what is going to happen until
after the project got approved -- that's a sure way to piss me of.

Anyway, I really hope I'm just a weird, grumpy guy who somehow missed a
well-targeted discussion. Hence, please do correct my impressions.

In the meanwhile, have fun

Trojita, a fast e-mail client --


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


Subject Author
[gentoo-doc] Re: okupy, a Django rewrite of www.g.o Theo Chatzimichos <tampakrap@g.o>