[Vim-l] Vim FAQ

[Sebastian Menge]

Am Tue, 02 Oct 2007 19:43:40 +1000 schrieb John Beckett:
> Yegappan has asked me for ideas on moving the FAQ to the Vim Tips wiki.

That's great :-)

> Proposal: Put each section in its own tip page, 

Exactly my first idea.

> using the convention of naming each tip
>     FAQ Title of section
> Currently, each section is numbered. I propose removing that number.

>     FAQ Introduction and contents
>     FAQ General information
>     FAQ Resources

Hmm, I would rather make a category FAQ, and avoid redundant fragments in 
the title. Perhaps an Overview page would be nice to mimic the TOC.

> The html version of the FAQ (URL above) has lots of links. I'm not sure
> how achievable that would be, but it's clearly what we should have.

> I envisage that some scripts would prepare the wiki pages from the text
> in vim_faq.txt.

Since the links are not in the txt version, I suppose the orinigal source 
is another format. When we make an import script we should import from 
that source which will hopefully have the URLs.

> One drawback is that people would no longer be able to download the
> complete FAQ (I suppose the original would still be available, but I

I could imagine some other script that collects all entries in categroy 
FAQ, and outputs nice html/txt/whatever.


Sebastian.