From mboxrd@z Thu Jan 1 00:00:00 1970 From: Sebastian Rose Subject: Re: Documentation wishlist items Date: Wed, 16 Sep 2009 16:10:46 +0200 Message-ID: <87r5u7f09l.fsf@gmx.de> References: <9cd2f5ff0909151421r25e4c7afn8d609e76e2462193@mail.gmail.com> <87tyz3a83l.fsf@gmx.de> <871vm78bjc.fsf@bzg.ath.cx> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MnvDk-0003yd-ER for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 10:10:56 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MnvDe-0003vB-Ox for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 10:10:54 -0400 Received: from [199.232.76.173] (port=53095 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MnvDe-0003v4-DT for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 10:10:50 -0400 Received: from mail.gmx.net ([213.165.64.20]:48842) by monty-python.gnu.org with smtp (Exim 4.60) (envelope-from ) id 1MnvDd-0003IT-AJ for emacs-orgmode@gnu.org; Wed, 16 Sep 2009 10:10:50 -0400 In-Reply-To: <871vm78bjc.fsf@bzg.ath.cx> (Bastien's message of "Wed, 16 Sep 2009 17:49:11 +0800") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Bastien Cc: emacs-orgmode Bastien writes: > Sebastian Rose writes: > >> Here is some kind of outline for such a tutorial. > > Wow. That an outline for a full book! > > And I guess that's what comes at the horizon: an (O-Reilly) book about > Org-mode. It would not compete with the manual as a reference, but it > would make it easier to more people to open Org's doors. OK, let's just start it. I'd like to have the tutorial on orgmode.org/worg. But I'm not yet sure about the structure. Option (A) is, to create an .../worg/the-org-tutorial/index.org, that just contains an index to the chapters. Each chapter goes to a single file in that directory. Option (B) Put the entire thing into one big file. This has the advantage, that we wouldn't need to create any extra directories on worg: orgmode.org/worg/org-tutorials/the-org-tutorial.org | | (A) Multiple files | (B) Monolitic | |----------------------------+--------------------+---------------| | Outlining a skeleton | - | + | | Restructure | - | + | | Multiple editors | + | - | | Distribution (e.g. as PDF) | - | + | | Easy navigation | + | - | |----------------------------+--------------------+---------------| | Sum | -1 | +1 | Thoughts? BTW: The first user in the tutorial is called Allice. I wanted to call her Trillian, but I'm afraid, people would let her add tasks, that are not easily understood :-D The readers are supposed to use their brain to understand Org-mode... Sebastian