From mboxrd@z Thu Jan 1 00:00:00 1970 From: Matt Price Subject: Re: Org Tutorials need more structure Date: Sun, 29 Sep 2013 11:31:00 -0400 Message-ID: References: <87ob7cxbjf.fsf@ericabrahamsen.net> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:33574) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQIxa-0000fC-QE for emacs-orgmode@gnu.org; Sun, 29 Sep 2013 11:31:03 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VQIxZ-0007Y5-J0 for emacs-orgmode@gnu.org; Sun, 29 Sep 2013 11:31:02 -0400 Received: from mail-qc0-x22e.google.com ([2607:f8b0:400d:c01::22e]:32833) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VQIxZ-0007Y0-Do for emacs-orgmode@gnu.org; Sun, 29 Sep 2013 11:31:01 -0400 Received: by mail-qc0-f174.google.com with SMTP id n9so2950562qcw.5 for ; Sun, 29 Sep 2013 08:31:00 -0700 (PDT) In-Reply-To: <87ob7cxbjf.fsf@ericabrahamsen.net> 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: Eric Abrahamsen Cc: Org Mode On Sun, Sep 29, 2013 at 4:44 AM, Eric Abrahamsen wrote: > 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 I would only add that "exporting" is closely linked to "writing in org" whcih is what I mostly do. This includes topics like footnotes, which I haven't really figured out yet after 3 years of using org (admittedly I haven't really tried either). It might also be nice if these tutorials included some sample setup code to get intermediate-to-advanced features working even before one fully understands them. Very busy the net 2 weeks but afte that I'd like to try to give back a little bit to the org community, so I could take a crack at some of these areas (not 3 & 4 though!). Matt > > 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 > >