[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

FAQs

From: Joshua Varner <jlvarner_at_gmail.com>
Date: 2005-06-29 19:34:07 CEST

I am interested in the FAQ manager position; as sad as this is, I'm
the local expert on svn since I'm the only one whose read the book yet
at our company.

I think the biggest problem right now is not the lack of FAQs you
have, but that they are not presented in a usable manner. I've seen a
number of e-mails saying 'I have this problem and looked at the FAQ,
but it wasn't there' that receive responses of 'Yes it it.'

The current break down of
    General Questions
    How To
    Trouble Shooting
    Developer
    Reference
reflects only one possible way of organizing the questions, and very
little granuality of concepts. Since I was thinking about volunteering
for the position I went to look at the existing FAQs, and it's hard
just to find out what is currently there.

I would recommend providing multiple ways of examining the questions
  General ( About, Getting Involved, Development, References,
Comparison . . . )
  How-To
    By Task (Repository Administration, Commiting, Branching, Error
Recovery . . . )
    By Platform (All, *nux, Windows, BSD . . . )
  Known Problems/Troubleshooting
    By Task (Repository Administration, Commiting, Branching, Error
Recovery . . . )
    By Platform (All, *nux, Windows, BSD . . . )
  By Program (moddav, svnserve, svnclient, bindings, . . . )
  Switching from X (Perforce, CVS, Clearcase . . . )

The major concern with maintaining this kind of list would be
automation, and it appears the the current FAQ is straight HTML, so
the question is what kind of build process would subversion be willing
to accept (offline - checking in the scripts and the generated file,
or on upload). I'm most comfortable with Perl or an XML/XSL type of
setup, but could use something else if that is desired.

I would definately need help as our office runs entirely on linux and
uses svnserve, so I have tended to skip the http and windows messages,
but I do read most of the e-mail coming through.

TIA,
Josh

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Wed Jun 29 19:35:00 2005

This is an archived mail posted to the Subversion Dev mailing list.