<div dir="ltr"><br><div class="gmail_quote"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><span class="">2014-09-27 12:47 GMT+02:00 Björn Pettersson <span dir="ltr"><<a href="mailto:bjorn@undef.io" target="_blank">bjorn@undef.io</a>></span>:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi list,<br>
<br>
First off I understand you've produced some kick-ass software, and I'd<br>
like to use it myself! Unfortunately the first thing people see is not<br>
the great software, but the documentation. The documentation is<br>
definitely okay, but I think we can make some improvements, and I want<br>
to help!<br>
<br>
I'm new to sheepdog and just started to read the Getting started guide.<br>
Most things I understand fine, but some things were a bit unclear and<br>
fuzzy. So I updated the wiki to reflect what I think you mean in a few<br>
places. Please review my changes (link below) so I'm not lying. ;)<br>
<br></blockquote><div><br></div></span><div>Hi, thank you for your review, I think the corrections you made are fine.<br><br></div><span class=""><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
But there were other parts where I'm not confident enough to make any<br>
changes. Like these:<br>
<br>
> Usually sheepdog and QEMU are installed on every node, and the cluster<br>
> manager on three nodes.<br>
<br>
Should this maybe say "and the cluster manager on all nodes"?<br></blockquote><div><br></div></span><div>corosync, all nodes;<br></div><div>zookeer, 3 nodes can monitor hundreds of other nodes. <br></div><span class=""><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
> Sheepdog has the back-end store to store the data object persistently<br>
> on the node basis.<br>
<br>
I don't really get this, could this be put in another way?<br></blockquote><div><br></div></span><div>I also don't get it.<br></div><div>If no one can explain it better, we can remove it.<br> <br></div><span class=""><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
> 2. Boot the virtual machine without sheep daemon started on local node<br>
> <pre><br>
> $ qemu-system-x86_64 sheepdog:192.168.2.45:7000:Alice<br>
<br>
Should this be "Boot the virtual machine with sheepdog daemon running on<br>
a remote node"?<br></blockquote><div><br></div></span><div>I think you can change it.<br></div><div>The following is a third way to say the same thing:<br></div><div>"Boot the virtual machine that is stored on the cluster from a server that isn't part of the cluster"<br></div><span class=""><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
Other points:<br>
<br>
o You use "sheepdog" and "Sheepdog" inconsistently, which one do you<br>
  wish to use? I can probably update it if you let me know.<br>
<br>
o Some places says "sheep daemon", should this be "sheepdog daemon"?<br>
  Again, just for the sake of consistency.<br></blockquote><div><br></div></span><div>Sheepdog refer to the project in general (so the combination of sheep and dog).<br></div><div>sheep is the name of prcess/daemon that is running on the server.<br></div><div>Like when speaking of Samba e smbd.<br></div><div>I think it's correct to use the upper case letter for Sheepdog because is the name of the project.<br></div><div>For sheep process, it's not.<br><br></div><span class=""><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
<br>
Please review the changes I made here:<br>
<a href="https://github.com/sheepdog/sheepdog/wiki/Getting-Started/_compare/cbc8900aca247a619222425b09bf94538712264e...410e3b4f510f9f1bd73c5fd677a8ef6efea415d9" target="_blank">https://github.com/sheepdog/sheepdog/wiki/Getting-Started/_compare/cbc8900aca247a619222425b09bf94538712264e...410e3b4f510f9f1bd73c5fd677a8ef6efea415d9</a><br>
<br>
And please let me know if this is appreciated and if you are interested<br>
in more feedback like this.<br></blockquote><div><br></div></span><div>Your review is very welcome and appreciated.<br></div><div>I recently made many changes on the "getting started" section but I got no time to review.<br></div><div>There were some new and old typos.<br><br></div><div>You may also want to read the Administrator Manual<br><a href="http://www.sheepdog-project.org/doc/" target="_blank">http://www.sheepdog-project.org/doc/</a><br><br></div><div>There are the same information you find in the wiki but more verbose and hopefully easier to understand for a new user.<br></div></div></div></div>
</div><br></div>