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

Re: FAQs

From: Gabor Szabo <szabgab_at_gmail.com>
Date: 2005-06-30 16:40:22 CEST

back to the mailing list with my response. I guess you wanted to send
it there too.

On 6/30/05, Joshua Varner <jlvarner@gmail.com> wrote:
> On 6/30/05, Gabor Szabo <szabgab@gmail.com> wrote:
> > On 6/29/05, Joshua Varner <jlvarner@gmail.com> wrote:
> > > I would recommend providing multiple ways of examining the questions
> >
> > This sounds like a good idea. In addition one might want to examine the
> > different ways people ask a question related to a topic and include all
> > those ways in the FAQ.
> >
> > I also think more links to the relevant discussions on the various mailings list
> > and to the entries in the Subversion book would allow users to
> > research a topic better.
> >
> I agree, that's one of the things I wanted to do, I've been saving
> e-mails that look promising.

>
> >
> > > The major concern with maintaining this kind of list would be
> > > automation, and it appears the the current FAQ is straight HTML,
> >
> > Have you checekd YAML to be used for source file format? AFAIK there are
> > tools in various languages to process YAML files. (see http://www.yaml.org/ )
> >
> I took a brief look a YAML and it looks like it would work. The
> question is what would be supported by Collabnet, since they are the
> ones hosting the site. I could probably do it with Javascript, too.
> But it comes down to what the hosting server is interested in
> supporting, either during the uploading process or on the fly (a la
> Javascript).
>
> The first patch I would want to do would be to provide this kind of
> organization. I can create an off-line process to generate the pages
> and send in a patch like that, but I would like to know what type of
> tool to use prior to doing that work.

AFAIK it would be better to create the HTML(s) off-line
or by the process that generates the web site from the repository.

Gabor

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Thu Jun 30 18:08:08 2005

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