From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Re: Org Tutorials need more structure Date: Sat, 28 Sep 2013 12:09:09 +0200 Message-ID: <68CAD3FD-52FD-4D7D-A4BA-E4823F57E506@gmail.com> References: <20130928104846.52fbe04c@aga-netbook> Mime-Version: 1.0 (Mac OS X Mail 6.6 \(1510\)) Content-Type: multipart/signed; boundary="Apple-Mail=_593F3E34-6335-409B-B592-50DDEE9F1CE9"; protocol="application/pgp-signature"; micalg=pgp-sha1 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:50693) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VPrSc-0001Pj-Pp for emacs-orgmode@gnu.org; Sat, 28 Sep 2013 06:09:19 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VPrSX-0006Jh-8i for emacs-orgmode@gnu.org; Sat, 28 Sep 2013 06:09:14 -0400 Received: from mail-wi0-x232.google.com ([2a00:1450:400c:c05::232]:40765) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VPrSW-0006JX-Ti for emacs-orgmode@gnu.org; Sat, 28 Sep 2013 06:09:09 -0400 Received: by mail-wi0-f178.google.com with SMTP id hn9so1860058wib.17 for ; Sat, 28 Sep 2013 03:09:08 -0700 (PDT) In-Reply-To: <20130928104846.52fbe04c@aga-netbook> 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: Marcin Borkowski Cc: emacs-orgmode@gnu.org --Apple-Mail=_593F3E34-6335-409B-B592-50DDEE9F1CE9 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 On 28.9.2013, at 10:48, Marcin Borkowski wrote: > Dnia 2013-09-28, o godz. 08:11:23 > Carsten Dominik napisa=C5=82(a): >=20 >> 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? >=20 > As I hinted in my previous email, there are two cases: >=20 > 1. Emacs users who are new to Org-mode. >=20 > This is basically covered by the manual. Period. >=20 > 2. People new to Emacs who might want to use it /because/ of Org-mode. >=20 > Here we have a huge potential for improvement, so to speak;). >=20 > A couple of thoughts: >=20 > - 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;). Hi Marcin, thanks for your input! However, for now, O was not asking for new material to be produced (even though that may be interesting as well), but rather I wanted to make a selection of the large numbers of talks, screencasts, tutorials that introduce into Org more progressively. For example, my talk at Google is too long as the first thing a newbie should encounter. I was hoping we can identify maybe 5 different things (screencasts, tutorials, whatever) that we advertise at the top of the tutorial page as the recommended default introduction into Org. The rest of the tutorial page is then still there as additional reference for people who stay and want to dig deeper. The problem I have with the tutorial page right now is that there is a huge amount of tutorials, and no guidance for beginners. - Carsten --Apple-Mail=_593F3E34-6335-409B-B592-50DDEE9F1CE9 Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename=signature.asc Content-Type: application/pgp-signature; name=signature.asc Content-Description: Message signed with OpenPGP using GPGMail -----BEGIN PGP SIGNATURE----- iQEcBAEBAgAGBQJSRqrFAAoJEO+gg/nAZuwMVmYH/31p27uZTD8pN30DF16fFDCa izMM+6V0ZFTJbOjDuyg9jgm4mJ/TXRoFK9cM13dxpxiE2fRz/MBemwBWfsdxpruv sJ9XAXQ4LsY9+oA/1fRV5WvDoAWDtNd0W/oQgowrtzUqBENskFuH96TkWcXL/KWU ULLOXaymB8iInLHZ6dN2a1zokBtGe5uOObC8MFbCJmy96xLT567aoES+f61f4CSK wk8MX3GGJ7Bs+ZFYpGCo2KNGVYglMkA90BnscQiNVsl4YEGL3E96/43Y3KInd7ex ze2n8qh89s2JxMAyC2/++FVXjN7632e9ZzyhJfaDC0a6phFlXLgWCcRQ/CBGW9o= =fxGa -----END PGP SIGNATURE----- --Apple-Mail=_593F3E34-6335-409B-B592-50DDEE9F1CE9--