Matthew:

There's an interest in org-help.org?  Would there be any question about its
inclusion in org? No.  It's currently in a state of disarray, however.  Here
are some of my thoughts about its current state.  As I mention below, I may
be able to clean it up this Summer.

  I am afraid I got bogged down, for a number of reasons.   I am stubborn,
and don't want to admit defeat, but it would be even better if someone who
really understands org-mode was able to carry it forward.   And I have some
ideas about improving it, but haven't had time or focus to get it done.
I'll attach a current copy, but there are quite a few sections added, esp.
at the end, that were gratuitously personal notes as I was learning certain
features.  If this were on some kind of git repo, I'd be interested in
working off of it, and I'd learn to submit a patch, perhaps.

One thing I thought about is the keystroke compatibility issue, that it
would be really nice if it worked like info.  As it is, it is an editable
file, and I end up having to kill it to avoid overwriting it with some junk,
when I use it.   The folding status is not persistent, another nice thing to
have (from info).

The file opens up as a folded top-level outline.  The various headlines I
have set up to be links to the manual pages about the same topic.  At I
tried to have one or two main keybinding clues present in the folded view at
least headline.  So a clue to the keybindings, and a link to the manual.
Even lower level headlines may have manual links.  That particular feature I
like *a lot*!

I have gotten a bit lost with many of the new features, like babel, and
haven't kept up on some of those.  I was clueless about agenda, but have
begun to use it quite a bit, so at some point I worked on that section, but
it's a miasma, a tangled mass, at this point, and I should have to clean
that up.  This is an example of a section I started to work on when I was
learning a certain feature or set of features.

So I guess that main caveat at this point is that it's become a personal
help file, and more and more personal as time goes on.  Summer comes I would
at some point clean it up.

I assigned it to a key.  For my key-binding setup, it worked ok to assign it
to "C-c 7".   Maybe better to set it on a viewing mode, but I have been
prone to hack as a go.

Be all that as it may be, here is the "current" state of the file on my
system.

Alan.

On Sun, May 16, 2010 at 10:43 PM, Matthew Lundin <mdl@imapmail.org> wrote:

> Carsten Dominik <carsten.dominik@gmail.com> writes:
>
> > Hi Matt,
> >
> > no, org-help.org is not about the FAQ, it is a separate document, like
> > a quick reference, made by Alan Davis.  It is more than the refcard,
> > less than the manual.
> >
> > It seems to live here:
> >
> >  http://osdir.com/ml/attachments/orgF54hhOaC48.org
> >
> > Get in touch with Alan at lngndvs@gmail.com  Maybe with some feedback
> > between the two of you, we will have a way to ship this with Org-mode
> > and to link it in.
>
> Great! I will contact Alan Davis about including org-help.org in the
> distribution.
>
> - Matt
>
>