Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 16 Dec 2012 19:59:47 -0500
From:      Eitan Adler <lists@eitanadler.com>
To:        Alex Weber <alexwebr@gmail.com>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: patch for ThwackAFAQ differences-to-other-bsds
Message-ID:  <CAF6rxgmhfWOUkVaHRNKcht8JbapgP3ouEM6Wcnq3Z2%2Bqwrj8Ew@mail.gmail.com>
In-Reply-To: <50CE6891.2080303@gmail.com>
References:  <50CE6891.2080303@gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help
--bcaec554d9d6ba41a904d101e74c
Content-Type: text/plain; charset=UTF-8

On 16 December 2012 19:34, Alex Weber <alexwebr@gmail.com> wrote:
> Hello list,
>
> This is my first patch to the FreeBSD docs, so please let me know if
> I've done something wrong! :)

This is a really good start!

A few comments.  Almost all of them are formatting, rather than
content nits. This is good. :)

- Try not to change whitespace and content in the same diff.  This
makes it harder for our translators to see what changed.
- The maximum line length is 70 (with some exceptions, e.g., for links)
- "FreeBSD" is spelled "&os;"
- http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/openssh.html
is spelled &url.books.handbook;/openssh.html
- ssh(1)  can also be spelled &man.ssh.1;
- items at the same indentation level should have an extra newline
- sentences have double spaces

I've attached a modified diff so you could see how it may look.




>
> This patch seeks to update the FAQ question "What are the differences
> between FreeBSD and NetBSD, OpenBSD, and other open source BSD operating
> systems?" listed in the ThwackAFAQ wiki.
>
> I've attached the patch as 'differences-to-other-bsds.patch'.
>
> -Alex Weber
>
> _______________________________________________
> freebsd-doc@freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org"
>



-- 
Eitan Adler

--bcaec554d9d6ba41a904d101e74c
Content-Type: application/octet-stream; name="new-differences.diff"
Content-Disposition: attachment; filename="new-differences.diff"
Content-Transfer-Encoding: base64
X-Attachment-Id: f_haswaoec1

Y29tbWl0IDljOWJlZWUzZTIyNGMzYzBhNDE2ZDg0MWIyMjg1YWVjNTkyNzRmMWYKQXV0aG9yOiBF
aXRhbiBBZGxlciA8bGlzdHNAZWl0YW5hZGxlci5jb20+CkRhdGU6ICAgU3VuIERlYyAxNiAxOTo1
NzozNyAyMDEyIC0wNTAwCgogICAgVXBkYXRlIGFuZCBleHBhbmQgb24gdGhlIGRpZmZlcmVuY2Vz
IHRvIG90aGVyIGJzZHMgcXVlc3Rpb24uCiAgICAKICAgIFN1Ym1pdHRlZCBieToJQWxleCBXZWJl
ciA8YWxleHdlYnJAZ21haWwuY29tPgogICAgQXBwcm92ZWQgYnk6CT8/PyAobWVudG9yKQoKZGlm
ZiAtLWdpdCBhL2VuX1VTLklTTzg4NTktMS9ib29rcy9mYXEvYm9vay54bWwgYi9lbl9VUy5JU084
ODU5LTEvYm9va3MvZmFxL2Jvb2sueG1sCmluZGV4IDQ0Y2M0YzAuLjNiMjk3YTYgMTAwNjQ0Ci0t
LSBhL2VuX1VTLklTTzg4NTktMS9ib29rcy9mYXEvYm9vay54bWwKKysrIGIvZW5fVVMuSVNPODg1
OS0xL2Jvb2tzL2ZhcS9ib29rLnhtbApAQCAtMzA1LDcgKzMwNSw0MCBAQAogCSAgICBkaWZmZXJl
bmNlcyBiZXR3ZWVuIHRoZSB2YXJpb3VzIHByb2plY3RzLAogCSAgICBjYWxsZWQgPHVsaW5rCiAJ
ICAgICAgdXJsPSJodHRwOi8vd3d3LmZyZWVic2R3b3JsZC5nci9mcmVlYnNkL2JzZC1mYW1pbHkt
dHJlZS5odG1sIj5UaGUgQlNEIEZhbWlseSBUcmVlPC91bGluaz4KLQkgICAgd2hpY2ggZ29lcyBh
IGZhaXIgd2F5IHRvIGFuc3dlcmluZyB0aGlzIHF1ZXN0aW9uLjwvcGFyYT4KKwkgICAgd2hpY2gg
Z29lcyBhIGZhaXIgd2F5IHRvIGFuc3dlcmluZyB0aGlzIHF1ZXN0aW9uLgorCSAgICBTb21lIG9m
IHRoZSBpbmZvcm1hdGlvbiBpcyBvdXQgb2YgZGF0ZSwgYnV0IHRoZSBoaXN0b3J5CisJICAgIHBv
cnRpb24gaW4gcGFydGljdWxhciByZW1haW5zIGFjY3VyYXRlLjwvcGFyYT4KKworCSAgPHBhcmE+
TW9zdCBvZiB0aGUgQlNEcyBzaGFyZSBwYXRjaGVzIGFuZCBjb2RlLCBldmVuIHRvZGF5LgorCSAg
ICBBbGwgb2YgdGhlIEJTRHMgaGF2ZSBjb21tb24gYW5jZXN0cnkuPC9wYXJhPgorCisJICA8cGFy
YT5UaGUgZGVzaWduIGdvYWxzIG9mICZvczsgYXJlIGRlc2NyaWJlZCBpbgorCSAgICA8eHJlZiBs
aW5rZW5kPSJGcmVlQlNELWdvYWxzIi8+LCBhYm92ZS4gIFRoZSBkZXNpZ24gZ29hbHMKKwkgICAg
b2YgdGhlIG90aGVyIG1vc3QgcG9wdWxhciBCU0RzIG1heSBiZSBzdW1tYXJpemVkIGFzCisJICAg
IGZvbGxvd3M6PC9wYXJhPgorCisJICA8aXRlbWl6ZWRsaXN0PgorCSAgICA8bGlzdGl0ZW0+CisJ
ICAgICAgPHBhcmE+T3BlbkJTRCBhaW1zIGZvciBvcGVyYXRpbmcgc3lzdGVtIHNlY3VyaXR5IGFi
b3ZlCisJCWFsbCBlbHNlLiBUaGUgT3BlbkJTRCB0ZWFtIHdyb3RlCisJCTx1bGluaworCQkgIHVy
bD0iJnVybC5ib29rcy5oYW5kYm9vazsvb3BlbnNzaC5odG1sIj5PcGVuU1NIPC91bGluaz4KKwkJ
YW5kICZtYW4ucGYuNDssCisJICAgICAgICB3aGljaCBoYXZlIGJvdGggYmVlbiBwb3J0ZWQgdG8g
Jm9zOy48L3BhcmE+CisJICAgIDwvbGlzdGl0ZW0+CisKKwkgICAgPGxpc3RpdGVtPgorCSAgICAg
IDxwYXJhPk5ldEJTRCBhaW1zIHRvIGJlIGVhc2lseSBwb3J0ZWQgdG8gb3RoZXIgaGFyZHdhcmUK
KwkJcGxhdGZvcm1zLjwvcGFyYT4KKwkgICAgPC9saXN0aXRlbT4KKworCSAgICA8bGlzdGl0ZW0+
CisJICAgICAgPHBhcmE+RHJhZ29uRmx5QlNEIGlzIGEgZm9yayBvZiAmb3M7Jm5ic3A7NC44IHRo
YXQgaGFzCisJCXNpbmNlIGRldmVsb3BlZCBtYW55IGludGVyZXN0aW5nIGZlYXR1cmVzIG9mIGl0
cyBvd24sCisJCWluY2x1ZGluZyB0aGUgSEFNTUVSIGZpbGUgc3lzdGVtIGFuZCBzdXBwb3J0IGZv
cgorCQl1c2VyLW1vZGUgPHF1b3RlPnZrZXJuZWxzPC9xdW90ZT4uPC9wYXJhPgorCSAgICA8L2xp
c3RpdGVtPgorCSAgPC9pdGVtaXplZGxpc3Q+CiAJPC9hbnN3ZXI+CiAgICAgICA8L3FhbmRhZW50
cnk+CiAK
--bcaec554d9d6ba41a904d101e74c--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAF6rxgmhfWOUkVaHRNKcht8JbapgP3ouEM6Wcnq3Z2%2Bqwrj8Ew>