> Absence of
> documentation, or old/poor
> documentation is a hassle.

Yes.

And is perhaps the most consistent and most often true critique of
open source projects of all stripes and generations (and a good many
proprietary systems too). In short, documentation is hard, good docs
doubly so. It's easy to miss what trips newbies up, it's easy to trip
friends, the familiar, with too much detail (they skip paragraphs
because the "they know that already" but miss a crucial new linchpin).

On the other hand projects which make an obvious and sustained effort
to counter this natural trend to entropy just feel more vibrant and
welcoming. To me.

So that's the tough nut, from my perspective. Fortunately I don't
think the documental entropy dragon needs to be slain outright to make
**great** improvements in Leo's documentation. What is lacking, in my
opinion, is focus. Not focus (so much)  for the master craftsmen, who
have a vibrant and active bazaar in the inner courtyard, rather focus
for the journeymen, apprentices, and tourists. The sometime visitors.

Simply put, there are too many websites. Too many places to look for
documentation, a.k.a help. Too many places to find out what's
happening and where Leo might, or might not, be going. Prune them all
except one I say. Or burn the field and plant a new one.

-matt

-- 
You received this message because you are subscribed to the Google Groups 
"leo-editor" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/leo-editor?hl=en.

Reply via email to