From mboxrd@z Thu Jan 1 00:00:00 1970 From: Eric Abrahamsen Subject: Re: Org Tutorials need more structure Date: Sun, 29 Sep 2013 15:44:04 +0700 Message-ID: <87ob7cxbjf.fsf@ericabrahamsen.net> References: Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:35528) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQCay-0008Hq-HL for emacs-orgmode@gnu.org; Sun, 29 Sep 2013 04:43:22 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VQCas-0003ts-AO for emacs-orgmode@gnu.org; Sun, 29 Sep 2013 04:43:16 -0400 Received: from plane.gmane.org ([80.91.229.3]:54072) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQCas-0003tD-3H for emacs-orgmode@gnu.org; Sun, 29 Sep 2013 04:43:10 -0400 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1VQCar-00012A-18 for emacs-orgmode@gnu.org; Sun, 29 Sep 2013 10:43:09 +0200 Received: from 61.247.48.25 ([61.247.48.25]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 29 Sep 2013 10:43:09 +0200 Received: from eric by 61.247.48.25 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sun, 29 Sep 2013 10:43:09 +0200 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Carsten Dominik writes: > Hi everyone, > > today I looked at our tutorial page at > > http://orgmode.org/worg/org-tutorials/index.html > > and came away with the feeling that that this page has become > somewhat useless for people who are really new to Org. I think > the page should start with a section of true recommendations > for beginners, a path we tell every new users to take in order to > learn about Org mode. > > Can we have a discussion here on how this path should look like? > When you came to Org-mode as a newby, what were the three resources > that really made an impression on by being accessible and > providing feel and promise for digging deeper? > > - Carsten My feeling is, the tutorial structure might look like this: Start with the basics: outlining and structure editing, plus introductions to links and properties. Then four other tutorials, presented in no particular order: 1. TODOs/agendas/task management (plus clocking) 2. Exporting 3. Babel 4. Tables/spreadsheets Those four areas seem pretty distinct and independent to me (except there's special cross-over between exporting and babel blocks). Any given prospective org user will probably immediately gravitate to one or more areas, leaving the others for later. Personally, I immediately jumped into task management, then went to exporting, and I've only ever dabbled in babel and spreadsheets. I think it would be good to keep these areas fairly self-contained. 2 cents, Eric