Re: Update documentation
From: Julian Foad <julianfoad_at_btopenworld.com>
Date: Fri, 11 Apr 2014 13:47:55 +0100 (BST)
Thank you for the patch. That 'best practices' file is certainly very out of date.
Mayuresh Rajwadkar wrote:
That's a good idea. The first replacement is fine. I think we can find better replacements for the links in the second and fourth sections -- have a look at the version I committed in http://svn.apache.org/r1586631 .
The recommendation to track merges manually, is totally obsolete. I couldn't think why you choose to link it to the "Merge-Sensitive Logs and Annotations" section? I think we should instead delete it, or replace it with a reference to the section on basic merging. For now, I have left it as it was.
We could argue that the whole file exists only for historical interest. It hasn't been materially updated since it was created, exactly ten years ago.
Maybe I'll commit some additional updates to the obsolete sections, or maybe I won't. We could at least add notes saying that they're obsolete.
This is an archived mail posted to the Subversion Dev mailing list.