The tests made for https://github.com/apache/subversion/pull/5 didn't even
require me to have Svn on my system. That's because I'm asserting against a
series of expected shell operations, because that's how the author
implemented svn-viewspec

Has anyone built Subversion on a Mac?
If yes, do you have the homebrew installables you needed handy?
#LemmeKnowPls

Observations:

   1. README and INSTALL don't have a TLDR "building subversion" section.
   2. .. should be converted to markdown with a .md suffix (industry
   convention)
   3. "IV. QUICKSTART GUIDE - See the final section of the first chapter of
   the Subversion Book]" should instead be inlined.
   4. "V. CONVERTING FROM CVS" should be relegated to similarly named file


GitHub have some general advice on readme's -
https://guides.github.com/features/wikis/
However, there's an effort to cajole the github masses into making better
readmes here - https://www.makeareadme.com/

Generally, the Subversion project should depend less on the Redbean book.
http://svnbook.red-bean.com/en/1.8/index.html is about 1.8 and it's marked
as DRAFT. There's no 1.9 or 1.10. While it is great that Msssrs.
Collins-Sussman, Fitzpatrick and Pilato persuaded O'Reilly to allow a full
public HTML version of the same, the Subversion project itself needs some
independence.

- Paul

Reply via email to