You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@subversion.apache.org by James Moger <ja...@transonic.com> on 2004/05/16 00:44:16 UTC
SVN Book...
Are there plans to incorporate the FAQ into the SVN book? The FAQ has
some good stuff in it.
The other thing I've noticed about the documentation is that
instructions for a Windows server installation defer to the TortoiseSVN
documentation. Wouldn't it make sense to incorporate Win server setup
instructions into the SVN book? It could be organized into *NIX
installation and Windows installation.
- James
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org
Re: SVN Book...
Posted by Ben Collins-Sussman <su...@collab.net>.
On Sat, 2004-05-15 at 19:44, James Moger wrote:
> Are there plans to incorporate the FAQ into the SVN book? The FAQ has
> some good stuff in it.
Look at the book's appendices. It does have the FAQ in it. Granted,
it's not kept perfectly in sync with the one on the web site, since FAQs
tend to get dated pretty easily. I tend to believe that most FAQs are
transient and generally better suited for a website.
> The other thing I've noticed about the documentation is that
> instructions for a Windows server installation defer to the TortoiseSVN
> documentation. Wouldn't it make sense to incorporate Win server setup
> instructions into the SVN book? It could be organized into *NIX
> installation and Windows installation.
The svn book discusses subversion in general, and tries to avoid
duplicating documentation for other technologies.
For example, the book covers *configuration* of servers, not OS-specific
installation details like, "here's how to install an RPM of apache" or
"here's how to run the win32 wizard of apache" or "here's a ssh binary
you should use on windows."
The tortoisesvn docs take a different approach: the docs which don't
specifically talk about tortoisesvn are 90% redundant with the svn book
or apache's docs. What makes them useful is that they're told from the
point of view of a shop that using nothing but win32. Definitely
useful, but the "official" SVN makes no such assumptions. It doesn't
try to cover any details of apache installation other than those
specific to Subversion, and assumes readers are able to use apache's own
Linux/win32 docs for generic installation or integration with things
like Linux PAM or win32 SSPI. Likewise, the main svn book discusses
integration with ssh, but doesn't tell users exactly which ssh client to
use on a particular OS.
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org