Nathan L. Adams wrote:
So you're saying that Gentoo consists of projects that are completely 'silo'd up' and have no bearing whatsoever on each other. Then the DevRel project only has bearing on those who actually join DevRel. Neat, a group formed for the sole purpose of coordinating itself. Security need only concern itself with securing its members (from who knows what!), and infra can just ignore the needs of everyone else (different project!). I wonder how any of the other projects *ever* made it onto the website...
Sigh, every project can set up it's own rules for internal project tasks, that means that internal docs could be a set of nice ascii art and then, you have a nice GuideXML page to point to them than happens to be translated on html/pdf/plaintext/whatever upon the necessities.
The errata.g.o (not the summaries w/ link that emerge would output) would obviously be documentation, would obviously be governed by the Doc rules, and it would be irrelevant which staff member happened to publish a particular guide. If Gentoo really is as balkanized as you state, then it is a sad state of affairs indeed. Maybe the 'full fledged' versions should be GuideXML-lite or something, I'm not sure, but your argument is just silly.
ARGH looks like MANY people do not get what is good about xml and what is not so good.
The whole point of using GuideXML is to make EASY convert to something else. NOT to use it.
The problem of using xml everywhere is that it is harder to write and has some work required in order to be parsed and translated.
So, if I have to set up an infrastructure that would require me to generate pdf, webpages, text, younameitwegetit and to update/write it not so often and not so quickly, I'd use xml.
If there is something that I'd have to write often by hand and quickly and has to be used as is mostly. I'd stay with a simpler format (that maybe is still machine parsable).
That said the format Ciaranm suggests for news looks ok for me. XML won't add anything but slowing me.
For an errata site GuideXML or an _extended_ version of it could be useful. lu
-----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (GNU/Linux) iD8DBQFDa5WH2QTTR4CNEQARAlERAKCeVue4ATD4fXBgLGdRAWt4Gi7vWgCcCs7R w/Pvjk9vv2C00HmrTkhBnHU= =Eiba -----END PGP SIGNATURE-----
-- Luca Barbato Gentoo/linux Developer Gentoo/PPC Operational Leader http://dev.gentoo.org/~lu_zero -- gentoo-dev@gentoo.org mailing list
