On 27 October 2011 18:32, Ryan Lane rlane32@gmail.com wrote:
[1] that is being updated. A lot of the live configs are also on NOC [2]. Between sites like NOC and access to Puppet (via Git), you've got a majority of the data AS it is actually used (rather than as it was, when written, on wiki).
Well, sure, but that's nap-of-earth; without a solid 5000ft view
grounding
you, I suspect it's hard to make use of.
I haven't yet read the book-prep page that was posted the other day; on reflection, I suspect that (and the book chapter that comes from it) will tell the things I'm looking for.
Basically everything is on noc and in puppet. Those will always be more up-to-date than our documentation. That said, most of our newer services are very well documented, and many of our older services have at least adequate documentation.
AFAIK, the only services with less than adequate documentation are the PDF servers and search. Mobile is slightly out of date since we just changed that entire architecture, but it'll be up to date soon.
- Ryan
That's not to say that the configuration files *themselves* couldn't do with a bit of a spring-clean, though. There are endless lines of commented-out hacks and twisted override-chains that make it very difficult to see where some things are configured from and what they are configured too. Of course, changing them runs the risk of inadvertantly removing some edgecase that was providing "expected behaviour" for some site; but that risk is run every time the config is updated *anyway*, it might as well be done in a controlled fashion.
--HM