Re: Structured Vim docs?

On 06/16/2010 08:39 PM, aleCodd wrote:
>

>>
>
> Can I disagree?
> for a newbie, i guess he is already overwhelmed with the option he gets
> after <c-d>

That is exactly one of the problems I'm trying to fix - you will be able
to type a few words and narrow down the results without being overwhelmed.

> and if not, helpgrep would definitely do the work.

helpgrep is a good tool but it works on level of lines instead of level
of subsection, you also have to get words in the right order (getting
them in any order is something new users may not know or remember), and
finally you don't see list or results immediately as you type.

Basically, a new user, in my opinion, should be able to get a list of
relevant topics with minimal fuss, i.e. something similar to typing a
query in a search engine. The reason why search engines are so popular
is that it's the most natural way to look for something. Often I've
found that it's easier to find some things through a search engine than
vim help - meaning, it's easier to find it within tens of billions of
pages of mostly irrelevant information than a few dozen of pages of 100%
relevant docs!

   -ak

--
 Python plugins for vim: outliner, todo list, project manager, calendar,
 expenses tracker, sortable table, and more | http://lightbird.net/pysuite/