Users Handbook

[Royce Williams]

On Fri, Nov 16, 2012 at 6:15 AM, Warren Block <wblock at wonkity.com> wrote:

[snip]

> The only way to force the user to pick a mirror is to change the example so it won't work until they do.  Like this:
>
>   Pick an svn mirror and replace the {svnmirror} string below with the
>   URL.
>
>   # svn checkout {svnmirror} /usr/ports
>
> That type of non-working example is confusing.  If we show one of the actual mirrors, 99% of users will cut and paste that example and not change it.  (Actually, that's an exaggeration.  It's closer to 100%.)
>
> I'd really like to do that better.  Any ideas?

Speaking pie-in-the-sky, is there an equivalent of fastest-cvsup for
SVN?  If not, creating a 'fastest-svn' and using that as the example
treats the cut-and-paste symptom.  Having a way to prompt the user to
ask if they want to cache its results might be even better.

Royce