emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: "Thomas S. Dye" <tsd@tsdye.com>
To: Carsten Dominik <carsten.dominik@gmail.com>
Cc: emacs org-mode mailing list <emacs-orgmode@gnu.org>
Subject: Re: A shorter manual
Date: Wed, 28 Apr 2010 06:45:57 -1000	[thread overview]
Message-ID: <E43EFE16-1939-45CB-8A44-835897B3E5FF@tsdye.com> (raw)
In-Reply-To: <096F60B3-65ED-464E-8CDC-1041CA69B706@gmail.com>


On Apr 28, 2010, at 5:46 AM, 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.
>
> - Carsten
>

Aloha Carsten,

I think this is a terrific idea, immediately useful.

The addition of hyperref links back to the advanced material in the  
manual might be useful and shouldn't require much maintenance.

A section at the end of each chapter, "Additional Reading," with links  
to Worg articles, etc. might also prove useful, but could be a pain to  
maintain.

All the best,
Tom

  parent reply	other threads:[~2010-04-28 16:52 UTC|newest]

Thread overview: 21+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2010-04-28 15:46 A shorter manual Carsten Dominik
2010-04-28 15:57 ` Erik Iverson
2010-04-28 17:05   ` Dan Davison
2010-04-28 18:43     ` Matti De Craene
2010-04-28 21:52       ` Carsten Dominik
2010-04-29 17:23         ` Dan Davison
2010-04-29 21:27           ` Carsten Dominik
2010-04-29 22:14             ` Dan Davison
2010-04-29 22:36               ` Samuel Wales
2010-04-30  6:47                 ` Carsten Dominik
2010-05-01  6:41                 ` Carsten Dominik
2010-04-30 14:12       ` Carsten Dominik
2010-05-02 10:13         ` Matti De Craene
2010-04-28 17:06   ` Dan Davison
2010-04-28 16:00 ` Marco
2010-04-28 16:45 ` Thomas S. Dye [this message]
2010-04-28 17:24 ` Samuel Wales
2010-04-28 17:27   ` Samuel Wales
2010-04-28 18:59     ` Thomas S. Dye
2010-04-28 21:34     ` Sebastian Rose
2010-04-29 22:37       ` Samuel Wales

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=E43EFE16-1939-45CB-8A44-835897B3E5FF@tsdye.com \
    --to=tsd@tsdye.com \
    --cc=carsten.dominik@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).