emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Documentation request
@ 2024-07-20 22:43 Peter Mao
  2024-07-22 13:44 ` Ihor Radchenko
  0 siblings, 1 reply; 9+ messages in thread
From: Peter Mao @ 2024-07-20 22:43 UTC (permalink / raw)
  To: org-mode-email

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

The docstrings for org-metadown and org-metaup (and maybe other
context-dependent commands) should reference the corresponding hooks,
org-metadown-hook and org-metaup-hook.

I recently ran into the (happy) situation where M-<down> popped me from an
org-babel code block into the corresponding session, but took a while to
figure out exactly how that was happening.

Peter

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

^ permalink raw reply	[flat|nested] 9+ messages in thread
* Documentation request
@ 2008-01-19 17:14 Sven Bretfeld
  2008-01-19 17:27 ` Adam Spiers
  2008-01-20 10:20 ` Rustom Mody
  0 siblings, 2 replies; 9+ messages in thread
From: Sven Bretfeld @ 2008-01-19 17:14 UTC (permalink / raw)
  To: emacs-org


[-- Attachment #1.1: Type: text/plain, Size: 2835 bytes --]

Hello to all

Org mode is powerful. This well-known, almost trivial, statement
contains a problematic dimension that is so far not solved in neither
the documentation nor in the various howtos all over the web: How do
newbies learn to make optimal use of all it's power?

I read quite a few descriptions of how to use org mode for GTD,
day-planning, even LaTeX-writing. But when reading this list I have
the impression that many members use org mode in a much more creative
way than I can imagine from reading what is to be found on the web.

I'm sure that I don't use the possibilities of org mode in an optimal
way, and that my concept of ordering data and using features is not
the best suitable for me. The major problem is as follows:

- Even if one knows what features are available in org-mode, it's hard
  to imagine what fine things you can actually do with them and how
  they could be used to complement each other in order to build up a
  meaningful overall concept.

In other words, it's a problem of imagination. This might be *my*
problem, but yet I believe that many users will have this same
difficulty, especially the new ones. John Wiegley's and Charles Cave's
howtos are fine and most instructive in this respect, but I have
different needs. I need more of these suggestions in order to pick out
ideas for my own style. On the org mode homepage there are several
descriptions of setups (Lisp code), but AFAIK only these two
explanations of concepts. We had many postings that gave a glimpse on
some concepts, but this is piecemeal.

What I would really like to see -- and now I come to my suggestion --
are some snapshots of org files by other users. What features are they
using and what for? What is the underlying concept of their
organization structure? What I need is the: "Aah, you are doing it
that way ..."

How do you think about making a space on the tutorial page of the org
mode homepage where people can upload example org-files, maybe
together with a short description of their concepts? Of course these
files have to be prepared in order to disguise their personal tasks
and dates, which are (of course) of no concern to the public, but they
should have to be recognizable as snapshots of a work-in-progress
("project A", "project B" isn't very instructive, I think. "Writing
chapter 4 of my dissertation thesis" would be much more informative).

I think this could be a valuable source for ideas how to optimize the
use of org mode, and it could give newbies (as well as experts) a
major clue to orientate themselves in the world of org mode.

I hope this request is not too silly. Of course, I would be willing to
become the first person to submit a file, although I believe that
there is not much to be learned from it.

Thanks for considering my request (and for reading this long message)

Sven

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 204 bytes --]

_______________________________________________
Emacs-orgmode mailing list
Remember: use `Reply All' to send replies to the list.
Emacs-orgmode@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-orgmode

^ permalink raw reply	[flat|nested] 9+ messages in thread

end of thread, other threads:[~2024-07-22 23:51 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2024-07-20 22:43 Documentation request Peter Mao
2024-07-22 13:44 ` Ihor Radchenko
2024-07-22 23:50   ` Peter Mao
  -- strict thread matches above, loose matches on Subject: below --
2008-01-19 17:14 Sven Bretfeld
2008-01-19 17:27 ` Adam Spiers
2008-01-20 22:31   ` Sven Bretfeld
2008-01-21 17:36   ` Sven Bretfeld
2008-01-20 10:20 ` Rustom Mody
2008-01-20 14:16   ` Carsten Dominik

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).