From: Matt Lundin <mdl@imapmail.org>
To: Ethan <ethan.glasser.camp@gmail.com>
Cc: emacs-orgmode <emacs-orgmode@gnu.org>
Subject: Re: Documentation wishlist items
Date: Tue, 15 Sep 2009 23:34:02 -0400 [thread overview]
Message-ID: <87pr9r36mt.fsf@fastmail.fm> (raw)
In-Reply-To: <9cd2f5ff0909151421r25e4c7afn8d609e76e2462193@mail.gmail.com> (Ethan's message of "Tue, 15 Sep 2009 17:21:12 -0400")
Ethan <ethan.glasser.camp@gmail.com> writes:
> Hi guys,
>
> I've been studying org-mode for a few months now, and I think I'm
> finally getting the hang of it.
I'm still saying the same thing after 1 year. :)
> It's really overwhelming, and I really appreciate the efforts that
> must have gone into the manual and the worg project. But I think it
> still needs work.
>
> The fundamental problem is that org-mode isn't a planner, it isn't an
> organizer.
???
> It's a toolkit full of tools which people use differently,
> in lots of ways, to build their own planner/organizer. To understand
> org-mode, you have to understand all of the tools available, and the
> options you have for each, and the ways they interact with the other
> tools.
I must respectfully disagree here. The org-mode basics are quite simple.
Create an outline, organize it however you see fit, mark actions as
TODOs, schedule, view and review using the agenda. To take advantage of
org, you really don't need to know much more than that. The basic
concepts would apply to any outliner or basic task management tool.
All the other features---clocking, properties, column view, exporting,
publishing, tags, tables/spreadsheets, effort estimates, etc.---are
there in the background in the event that you need them.
Heck, even without all the extras, org would still be a world-class
outliner.
> For example, let's take Archiving. The documentation I'm reading right
> now, at http://orgmode.org/manual/Archiving.html#Archiving, puts
> archiving in "Document Structure", section 2.6, before TODO keywords,
> tags, the agenda, or anything else. There's one paragraph about what
> archiving means, then five or six paragraphs about how a headline with
> the ARCHIVE tag behaves, and then a section about moving trees and
> where you could move them. It isn't clear what workflows you might use
> Archive Sibling in, or why C-u C-c C-x C-s would archive *children* of
> the selected headline instead of the headline itself.
The manual is not your only source of information. I make heavy use of
C-h v and C-h f to learn more about particular variables and functions.
> Another good example is TODO keywords, categories, and tags. It isn't
> clear what they all are, or why they are distinct, or what the
> differences are, and it's easy to confuse them with similarly-named but
> completely distinct concepts like properties.
Here's how I see it.
1) TODO keywords: How does this item fit into my workflow?
2) Category: What group does this tree belong to? (This is the word that
appears next to the item in the agenda.)
3) Tags: What words do I want to add to this item/tree to enable me to
find it easily. (Commonly used for GTD contexts.)
4) Properties: What extra data would I like to attach to this item?
(Commonly used to set special options for a subtree/item, but also
very useful for creating ad-hoc "databases".)
In my opinion, one of the biggest decisions new users have to make is
how to designate projects. Should I use a TODO keyword, a tag, or a
second level headline? I prefer the todo keyword "PROJECT" myself, but
any of these would work fine.
And if you regret the decision three months from now, you can always use
org-map-entries to change your project items en masse.
> Reading HOWTO's like Bernt Hansen's and Charles Cave's are really
> interesting to see how people work, but even documents like these don't
> explain *why* they set things up in this way. For example, Bernt
> Hansen's document explains that his toplevel headings are "main
> categories", and shows that they each have a CATEGORY property, but
> doesn't explain what that buys him, or what problem that solves.
My guess is that this allows him to see what group an item belongs to in
the agenda view, since categories are listed in the left column.
But this is like asking why someone puts their pots in the cupboard next
to the oven rather than above the sink, or why someone uses legal pads
rather than a spiral notebook.
My recommendation: Just start creating trees, use only a few TODO
states, and allow the organization to evolve in the way that feels the
most comfortable to you.
Best,
Matt
next prev parent reply other threads:[~2009-09-16 3:29 UTC|newest]
Thread overview: 26+ messages / expand[flat|nested] mbox.gz Atom feed top
2009-09-15 21:21 Documentation wishlist items Ethan
2009-09-15 23:56 ` Sean Sieger
2009-09-16 3:20 ` Sebastian Rose
2009-09-16 9:46 ` Bastien
2009-09-16 9:54 ` Greg Newman
2009-09-16 10:04 ` timetrap
2009-09-16 12:17 ` Jean-Marie Gaillourdet
2009-09-16 12:56 ` Peter Frings
2009-09-16 9:49 ` Bastien
2009-09-16 14:10 ` Sebastian Rose
2009-09-16 16:03 ` Matt Lundin
2009-09-16 12:46 ` Matt Lundin
2009-09-16 3:34 ` Matt Lundin [this message]
2009-09-16 11:37 ` Bernt Hansen
2009-09-16 15:33 ` Ethan
2009-09-16 16:32 ` Matthew Lundin
2009-09-16 18:42 ` tycho garen
2009-09-18 15:02 ` org-invoice question Dave Täht
2009-09-21 17:15 ` Peter Jones
2009-09-21 17:30 ` Dave Täht
2009-09-18 15:19 ` org-examples.git? Dave Täht
2009-09-18 17:00 ` org-examples.git? Matt Lundin
2009-09-16 9:42 ` Documentation wishlist items Bastien
2009-09-17 3:46 ` Matt Lundin
2009-09-17 17:34 ` Ethan
2009-09-17 19:30 ` Matthew Lundin
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87pr9r36mt.fsf@fastmail.fm \
--to=mdl@imapmail.org \
--cc=emacs-orgmode@gnu.org \
--cc=ethan.glasser.camp@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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).