Re: Org Tutorials need more structure

[Joseph Vidal-Rosset <joseph.vidal.rosset@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 2411 bytes --]

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

Jo.


2013/9/28 Carsten Dominik <carsten.dominik@gmail.com>

> 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
>

[-- Attachment #2: Type: text/html, Size: 3220 bytes --]