<!DOCTYPE html>
<html>
<head>
<title></title>
</head>
<body><div>Hi Nic,<br></div>
<div> </div>
<div>Your edits make sense. Go ahead and land them. Thanks for the extra information!<br></div>
<div> </div>
<div>Third person.<br></div>
<div>That is definitely the goal for the reference docs, though I did stick deliberately with the second person for the install guides.<br></div>
<div> </div>
<div>Terms: tldr - let's use "frontend" and "backend". <br></div>
<div> </div>
<div>From the point of view of word nerds, both terms started off either with a space or a hyphen but are graduating towards dropping the split and forming a single word. Using google trends to examine current typical usage shows that "backend" is comfortably established, while "frontend" and "front end" are about equal. In the interests of consistency (as I don't have a strong preference either), I figure let's use backend and frontend. I'll make that change today unless anyone pipes up with a better idea.<br></div>
<div> </div>
<div>Murderous replication.<br></div>
<div>As far as I can tell, we don't yet have instructions on configuring replication in a murder environment anywhere. Once I convince someone to write them (<i>Ken, I'm looking at you!</i>), I can look at where they'll best fit. It may end up in a separate document and I'll just cross-link from both sides.<br></div>
<div> </div>
<div> Nicola</div>
<div> </div>
<div> </div>
<div> </div>
<div>On Fri, Aug 21, 2015, at 05:38 AM, Nic Bernstein wrote:<br></div>
<blockquote type="cite"><div>Nicola,<br></div>
<div>
I've edited your recent commit of Murder docs, and added some stuff
therein. Please take a look at D69 and send me any feedback. If
you've not got a problem with it, then one or the other of us should
land it. Just let me know.<br></div>
<div> </div>
<div>
Based on your commit comment recently, something like "<span>Rewording install guide to
third person." I've been trying to do the same for the reference
docs we're preparing. Was this your intent, too; to aim for third
person for all docs? I'd like to see that, although I'll admit
that there are times where second person allows for more
expeditious conveyance of information. Whatever you think is
best, I'll gladly follow.<br>
<br>
Similarly, we have a mix of, for example, "frontend" and "front
end" in the Murder docs. I think we should standardize, but have
no strong preference as to which is better. The former seems to
better serve as a noun, but the latter lends itself to list
usages, such as "both front and back ends should have
``servername`` set..." Again, you lead, I'll follow. But
whatever the decision is, let's effect a bulk replace to cope with
it.<br>
<br>
Lastly, Ellie had suggested, in IRC:<br>
</span>
</div>
<blockquote>i'm thinking, maybe the murder docs should include
specifics on replication in a murder environment (assuming you
probably want the one if you've got the other), and the
replication-only doc should just be like "if you're using a
murder, see the other doc instead"<br></blockquote><div><span>Given the current state of
both documents, which is quite different than that Ellie was
commenting upon, do we still think this would be a Good Thing®?
I'm ambivalent, but will be glad to do whatever needs doing for
this.<br>
<br>
Your thoughts? Anyone else (there's a reason this is posted to
the list, too)?<br>
<br>
Cheers,<br>
-nic<br>
</span>
</div>
<pre>--
Nic Bernstein <a href="mailto:nic@onlight.com">nic@onlight.com</a>
Onlight, Inc. <a href="http://www.onlight.com">www.onlight.com</a>6525 W Bluemound Road, Suite 24 v. 414.272.4477
Milwaukee, Wisconsin 53213-4073
<br></pre><p>Email had 1 attachment:<br></p><ul><li><div><code>nic.vcf</code><br></div>
<div> 1k (text/x-vcard)<br></div>
</li></ul></blockquote><div> </div>
</body>
</html>