Carsten Dominik wrote:
Dear all,
with the Org-mode manual moving toward 200 pages, I am
starting to worry that people with stop in their tracks
when considering Org-mode, just because of the sheer size
of the manual.
So I did a little experiment. I took the manual and stripped
everything which could be considered advanced material, but
keeping all features and all basic commands and customizations.
What remains are about 50 pages. A document with the same
structure (even the same chapter numbers) as the manual.
I am wondering if it would be useful to have this as a beginners
document - or if the existence of this document would lead
to more confusion than relief.
http://orgmode.org/orgguide.pdf
I don't see this a an alternative for the manual - just
as an additional, rather static document, with little need for
updates. The manual would continue to be the comprehensive
and constantly updated document.
Comments are welcome.
I think it's a great idea. The R project has something called "An
Introduction to R" for beginners, separate from the complete manual. I
think that as a beginner, and wondering how to break into learning a new
package, that "reading the manual" has certain negative psychological
connotations that "reading the intro document" does not, not the least
of which is the length of full manual.
And since knowing just the basics of org can be immensely beneficial, I
think it's even more reason to have a basic intro document.
--Erik
_______________________________________________
Emacs-orgmode mailing list
Please use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode
