From mboxrd@z Thu Jan 1 00:00:00 1970 From: Marcin Borkowski Subject: Re: Org Tutorials need more structure Date: Sat, 28 Sep 2013 10:48:46 +0200 Message-ID: <20130928104846.52fbe04c@aga-netbook> References: Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:38844) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VPqCs-0001wT-Tp for emacs-orgmode@gnu.org; Sat, 28 Sep 2013 04:48:59 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VPqCo-00015K-4e for emacs-orgmode@gnu.org; Sat, 28 Sep 2013 04:48:54 -0400 Received: from msg.wmi.amu.edu.pl ([2001:808:114:2::50]:58965) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VPqCn-00014x-Sg for emacs-orgmode@gnu.org; Sat, 28 Sep 2013 04:48:50 -0400 Received: from localhost (localhost [127.0.0.1]) by msg.wmi.amu.edu.pl (Postfix) with ESMTP id 13F8E4AA3D for ; Sat, 28 Sep 2013 10:48:48 +0200 (CEST) Received: from msg.wmi.amu.edu.pl ([127.0.0.1]) by localhost (msg.wmi.amu.edu.pl [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id UCT7rawj-FSF for ; Sat, 28 Sep 2013 10:48:47 +0200 (CEST) Received: from aga-netbook (99-52.echostar.pl [213.156.99.52]) by msg.wmi.amu.edu.pl (Postfix) with ESMTPSA id D8DE24AA3A for ; Sat, 28 Sep 2013 10:48:47 +0200 (CEST) In-Reply-To: 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 Dnia 2013-09-28, o godz. 08:11:23 Carsten Dominik napisa=C5=82(a): > Hi everyone, >=20 > today I looked at our tutorial page at >=20 > http://orgmode.org/worg/org-tutorials/index.html >=20 > 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. >=20 > 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? As I hinted in my previous email, there are two cases: 1. Emacs users who are new to Org-mode. This is basically covered by the manual. Period. 2. People new to Emacs who might want to use it /because/ of Org-mode. Here we have a huge potential for improvement, so to speak;). A couple of thoughts: - Screencasts and videos might be a viable option (even though it is a bit old, I consider your Google lecture a very good introduction to Org-mode - a survey of features; it is, however, aimed more at a power user than a newbie). - What might be really interesting would be something along the lines of C-h t. In fact, the Emacs tutorial itself badly needs an update imho. And a similar thing for Org-mode might be even better. In fact, though I am quite busy at the moment, I'd be happy to start thinking about something like this in my free time. What do you think? - For new users, there might be an installation instruction /including/ installing Emacs (especially on Windows machines, where it might be tricky). I think it should be emphasized that (at least in case of Org-mode) Emacs may be treated more as an application framework, which incidentally has more text-editing capabilities than, say, edit boxes of GTK etc. (just a bit more, you know;)), and that Org-mode is an application running in this particular environment. (Calling it an Elisp Virtual Machine might be a bit stretching, though;).) - Last but not least: we are still waiting for Sacha Chua to draw a sketchnote-based intro to Org-mode;). > - Carsten Best, --=20 Marcin Borkowski http://octd.wmi.amu.edu.pl/en/Marcin_Borkowski Adam Mickiewicz University