Re: [Openvpn-devel] [PATCH] Use example.com to improve clarity of documentation

2015-12-15 Thread Gert Doering
Hi, On Tue, Dec 15, 2015 at 08:54:23PM +0100, Steffan Karger wrote: > Ooh, I like using alice and bob! +1 I'm fine with using example.com, but "host1" and "host2" just didn't ring true (but I was too busy to spell this out). gert -- USENET is *not* the non-clickable part of WWW!

Re: [Openvpn-devel] [PATCH] Use example.com to improve clarity of documentation

2015-12-15 Thread Selva Nair
On Tue, Dec 15, 2015 at 2:54 PM, Steffan Karger wrote: > On Tue, Dec 15, 2015 at 8:46 PM, David Sommerseth > wrote: > > On 30/11/15 04:03, Phillip Smith wrote: > >> This patch uses the generic "host1.example.com" and "host2.example.com" > to > >> replace the current "may" and "june" hostname exa

Re: [Openvpn-devel] [PATCH] Use example.com to improve clarity of documentation

2015-12-15 Thread Steffan Karger
On Tue, Dec 15, 2015 at 8:46 PM, David Sommerseth wrote: > On 30/11/15 04:03, Phillip Smith wrote: >> This patch uses the generic "host1.example.com" and "host2.example.com" to >> replace the current "may" and "june" hostname examples. Generic names chosen >> rather than other names like "server"/

Re: [Openvpn-devel] [PATCH] Use example.com to improve clarity of documentation

2015-12-15 Thread David Sommerseth
On 30/11/15 04:03, Phillip Smith wrote: > This patch uses the generic "host1.example.com" and "host2.example.com" to > replace the current "may" and "june" hostname examples. Generic names chosen > rather than other names like "server"/"client" or > "head-office"/"remote-office" > etc which may c

Re: [Openvpn-devel] [PATCH] Use example.com to improve clarity of documentation

2015-12-15 Thread Steffan Karger
Hi Philip, On Mon, Nov 30, 2015 at 4:03 AM, Phillip Smith wrote: > This patch uses the generic "host1.example.com" and "host2.example.com" to > replace the current "may" and "june" hostname examples. Generic names chosen > rather than other names like "server"/"client" or > "head-office"/"remote

[Openvpn-devel] [PATCH] Use example.com to improve clarity of documentation

2015-11-30 Thread Phillip Smith
This patch uses the generic "host1.example.com" and "host2.example.com" to replace the current "may" and "june" hostname examples. Generic names chosen rather than other names like "server"/"client" or "head-office"/"remote-office" etc which may create other unintended or implicit meanings to the r

Re: [Openvpn-devel] [PATCH] Use example.com to improve clarity of documentation

2015-11-30 Thread Phillip Smith
On 27 November 2015 at 13:35, Selva Nair wrote: > > Replacing references to "june.kg" etc., which could one day become someone's > private domain, is not a bad move. Though, not sure > why choose example.com over example.net or example.org, or even tlds like > .example, .test etc. which are also

Re: [Openvpn-devel] [PATCH] Use example.com to improve clarity of documentation

2015-11-27 Thread Selva Nair
Hi, On Tue, Nov 17, 2015 at 7:51 PM, Phillip Smith wrote: > The example.com domain is set aside defined by IANA for use as > documentation > examples. Replacing references to "june.kg" etc., which could one day become someone's private domain, is not a bad move. Though, not sure why choose exa

[Openvpn-devel] [PATCH] Use example.com to improve clarity of documentation

2015-11-18 Thread Phillip Smith
The example.com domain is set aside defined by IANA for use as documentation examples. Refer to: http://www.iana.org/domains/reserved Using this well-known domain makes comprehension of documentation easier. Signed-off-by: Phillip Smith --- doc/openvpn.8 | 35 ++-