[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [O] Org Tutorials need more structure

From: Joseph Vidal-Rosset
Subject: Re: [O] Org Tutorials need more structure
Date: Sat, 28 Sep 2013 09:22:02 +0200

Hi Dominik, hi everyone,

Thank you for org-mode and thanks to all who contribute to this project. 

I am a newby to org-mode , I am an emacs user for LaTeX, mainly, and I would be happy to use more and more emacs, so org-mode seems very attractive. 

I imagine that writing a tutorial is a big work and I hope that I will not offend people who have taken this time. But I must say that the org-mode manual and the tutorials that I have tried to read are not enough progressive for beginners and do not take care of difference between interests of people. 

Example: I am presently mainly interested to see if it is possible to use gnus to write a scientific letter with all conveniences of texlive. Of course I can open a tex file with letter class and send to my colleague a pdf file. But it would be more convenient to write an email and using conversions to html and png images to send to him directly this email. I guess it is possilbe to do it with gnus. But the documentation is esoteric: I hear about links, but how it works concretly with example understanble by a newby ...  mystery. It is therefore frustrating and quickly discouraging. 

So, in my opinion, a good tutorial is divided into precise tasks and speaks like that: 
"You need to do that?  So, follow me , from step to step, I will going to show you how I succeed to do what you want to do, and by imitation, you will also succeed ! "  A good tutorial avoids to suppose that the reader is already an expert. 

In a word, too much tutorial in org-mode lack of pedagogical efforts.

Sorry to be speak so frankly, but I hope it will help. 

Waiting your help with gnus - latex and conversion in html , etc. etc. 

All the best


2013/9/28 Carsten Dominik <address@hidden>
Hi everyone,

today I looked at our tutorial page at


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

reply via email to

[Prev in Thread] Current Thread [Next in Thread]