On Mon, Apr 14, 2014 at 6:19 PM, Bryan Davis <bd808(a)wikimedia.org> wrote:
I took a shot at creating jenkins configuration [0]
that would build
and publish documentation based on puppet manifests themselves. This
seems like a better long term solution to the problem. I'm all for
documenting things on wiki but in my experience the closer the
documentation is to the implementation the more likely it will be
updated when the implementation changes.
[0]:
https://gerrit.wikimedia.org/r/#/c/125919/
This job is enabled in Jenkins now. You can read the documentation of
just the roles [1] and/or the full puppet doc [2] for all classes
included in MediaWiki-Vagrant puppet configuration.
[1]:
https://doc.wikimedia.org/mediawiki-vagrant/classes/__site__/role.html
[2]:
https://doc.wikimedia.org/mediawiki-vagrant/
Bryan
--
Bryan Davis Wikimedia Foundation <bd808(a)wikimedia.org>
[[m:User:BDavis_(WMF)]] Sr Software Engineer Boise, ID USA
irc: bd808 v:415.839.6885 x6855