On Mon, Apr 14, 2014 at 4:35 PM, Steven Walling <swalling(a)wikimedia.org> wrote:
Please help fill in
https://www.mediawiki.org/wiki/MediaWiki-Vagrant/Roles:)
It's hard to know what a role does precisely without more docs than are
provided via the 'vagrant list-roles' command. Maybe we could add a
description to the list there? First step would be getting content I guess.
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/
--
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