<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Sat, May 23, 2015 at 3:27 AM, Nate Finch <span dir="ltr"><<a href="mailto:nate.finch@canonical.com" target="_blank">nate.finch@canonical.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">I just created a wiki page on the juju github repo to hold the information I typed up about running and writing CI tests, from my experience of the last week or so: <a href="https://github.com/juju/juju/wiki/ci-tests" target="_blank">https://github.com/juju/juju/wiki/ci-tests</a><div><br></div><div>It occurs to me that much of the documentation that we have in files inside the repo might be more appropriate in the wiki, such as basically everything here: <a href="https://github.com/juju/juju/tree/master/doc/contributions" target="_blank">https://github.com/juju/juju/tree/master/doc/contributions</a></div><div><br></div><div>The reason that I like the documentation to be in the wiki rather than in files in the repo is that it lowers the barrier of entry to adding and updating the documentation... plus it makes the files a lot more casually browseable.</div><div><br></div><div>Certainly, if we have documentation that is likely to change per-branch, then living in the repo makes sense... but I think that for things that are likely to be long-lived, like contributing docs, development how-to docs, etc, then the wiki has many benefits.</div></div></blockquote><div><br></div><div>Sounds good. I'd like to see the contents of the juju/juju/docs directory on the wiki, cross-referenced. It'd be nice to build up docs about the model, and about how various pieces (e.g. bootstrap) work.</div><div><br></div><div>My initial concern was that it might mean I can't access things on my machine, without the Internet, but the wiki is Git-based so that's no problem.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>Thoughts?</div><span class="HOEnZb"><font color="#888888"><div><br></div><div>-Nate</div><div><br></div><div><br></div><div><br></div></font></span></div>
<br>--<br>
Juju-dev mailing list<br>
<a href="mailto:Juju-dev@lists.ubuntu.com">Juju-dev@lists.ubuntu.com</a><br>
Modify settings or unsubscribe at: <a href="https://lists.ubuntu.com/mailman/listinfo/juju-dev" target="_blank">https://lists.ubuntu.com/mailman/listinfo/juju-dev</a><br>
<br></blockquote></div><br></div></div>