idiotprogrammer wrote:
> As a general remark, let me state that there have been many situations
> where I have needed to download a subversion directory, and the
> project website will say, download this branch, use TortoiseSVN and
> rather that explain what steps to take, they simply link to the
> Tortoise documentation.
>
> This happens often enough that I smell a trend. The problem is that
> Tortoise documentation is less geared to daily use than to server
> administration. As such, it is mostly useless for users like myself.
You're kidding, right?
The TSVN docs are for everyone. Sure, there's a whole chapter on how to
set up a server, and that chapter comes before the 'daily use guide',
but what do you expect? Starting to use TSVN without having a server set
up? Yes, if someone else has already done that, then you don't have to
do this yourself. But you should be intelligent enough to skip a chapter.
> (An exception is the wordpress docs to using subversion, which seems
> logical and straightforward http://codex.wordpress.org/Installing/Updating_WordPress_with_Subversion
> ).
That not only explains subversion badly, it is also very specific to
that website. Which means pretty useless for all other sites and
repositories.
The TSVN docs don't explain Subversion in detail - that's what the
Subversion book is for. And that's why the very first chapter in TSVN
tells you to first read that book (available online for free). Because
why should TSVN explain the same thing as is explained there?
> For example, if you look at TortoiseSVN docs, the first step to take
> seems to be the first step to take seems to be this topic
> http://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-checkout.html
> , and this appears in Chapter 5. And even then, I'm not sure if
> checking out is really the first step I'm supposed to take.
Yes, in the 'daily use guide'. Where would you expect that to be instead?
And if you don't know if checking out is the step you want, then no docs
can really help you. At least no docs about Subversion clients. You then
need specific docs about the projects you want to use. How should TSVN
(or any other svn client) know what *you* want to do? The docs can only
tell you *how* to do it.
> Here's a question that maybe you can answer: Does TortoiseSVN provide
> a way to turn (albeit temporarily) the failure noise? I've always been
> wondering on how to do this.
You can configure those in the normal windows sound setting panel.
>> Although my question may have to do with this epub project, I actually
>> have the same question as it pertains to another sourceforge project.
>> Maybe I should contact the people at sourceforge? The problem is that
>> I cannot make sense of the ViewVC view provided.
You can not use any subversion client on a ViewVC URL - those are URLs
for your web browser. You have to use the URL to the *repository*
instead. And each sourceforge page where it tells you how to get the
sourcecode clearly states that. And those pages also tell you the URL to
the repository.
Don't blame us and our docs if you don't read the instructions on the
websites you want to use.
Stefan
--
___
oo // \\ "De Chelonian Mobile"
(_,\/ \_/ \ TortoiseSVN
\ \_/_\_/> The coolest Interface to (Sub)Version Control
/_/ \_\ http://tortoisesvn.net
Received on 2008-04-13 15:41:23 CEST