emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Valid use cases for lists?
@ 2015-08-19 19:32 Chris Patti
  2015-08-19 19:55 ` Rasmus
                   ` (3 more replies)
  0 siblings, 4 replies; 9+ messages in thread
From: Chris Patti @ 2015-08-19 19:32 UTC (permalink / raw)
  To: emacs-orgmode

Can anyone give me an example of when it's a good idea to use lists
rather than headlines?

They feel rather like a violation of the principle of least surprise
to me, because when you use them, and then try to use pretty much any
other Org feature on them (marking them as a TODO item, tagging, etc.)
it doesn't work because lists aren't meant to be used that way.

I'm guessing I'm missing something obvious here, and that's why I'm asking.

Thanks in advance!
-Chris

-- 
Christopher Patti - Geek At Large | GTalk: cpatti@gmail.com | AIM:
chrisfeohpatti | P: (260) 54PATTI
"Technology challenges art, art inspires technology." - John Lasseter, Pixar

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

* Re: Valid use cases for lists?
  2015-08-19 19:32 Valid use cases for lists? Chris Patti
@ 2015-08-19 19:55 ` Rasmus
  2015-08-20 15:18   ` Mike McLean
  2015-08-21  3:59   ` Peter Salazar
  2015-08-19 20:00 ` Kyle Meyer
                   ` (2 subsequent siblings)
  3 siblings, 2 replies; 9+ messages in thread
From: Rasmus @ 2015-08-19 19:55 UTC (permalink / raw)
  To: emacs-orgmode

Chris Patti <cpatti@gmail.com> writes:

> I'm guessing I'm missing something obvious here, and that's why I'm asking.

Export.  List are used everywhere.

-- 
The right to be left alone is a human right

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

* Re: Valid use cases for lists?
  2015-08-19 19:32 Valid use cases for lists? Chris Patti
  2015-08-19 19:55 ` Rasmus
@ 2015-08-19 20:00 ` Kyle Meyer
  2015-08-19 21:02 ` Florian Beck
  2015-08-20 14:06 ` Matt Lundin
  3 siblings, 0 replies; 9+ messages in thread
From: Kyle Meyer @ 2015-08-19 20:00 UTC (permalink / raw)
  To: Chris Patti; +Cc: emacs-orgmode

Chris Patti <cpatti@gmail.com> writes:

> Can anyone give me an example of when it's a good idea to use lists
> rather than headlines?

I think there are quite a few, but here's one example.  I keep a heading
with a list of links to potentially interesting articles that I don't
have time to process at the moment when I encounter them.  I capture new
links (with no description) as items under this heading.  I don't want
to use a separate heading for each link because I don't want to think
about a name to give the heading.  I just want a list of links where I
can check off items when I get around to visiting them.

> They feel rather like a violation of the principle of least surprise
> to me, because when you use them, and then try to use pretty much any
> other Org feature on them (marking them as a TODO item, tagging, etc.)
> it doesn't work because lists aren't meant to be used that way.

That is pretty much how I decide.  If I think I need heading-specific
features, I use headings.

--
Kyle

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

* Re: Valid use cases for lists?
  2015-08-19 19:32 Valid use cases for lists? Chris Patti
  2015-08-19 19:55 ` Rasmus
  2015-08-19 20:00 ` Kyle Meyer
@ 2015-08-19 21:02 ` Florian Beck
  2015-08-20 14:06 ` Matt Lundin
  3 siblings, 0 replies; 9+ messages in thread
From: Florian Beck @ 2015-08-19 21:02 UTC (permalink / raw)
  To: emacs-orgmode


> Can anyone give me an example of when it's a good idea to use lists
> rather than headlines?

Headlines often are too heavy for my taste. My reading notes as well as
my notes for writing usually do not have a title. (You might think it good
practice to come up with a title, but my experiments tell me otherwise.)
Headlines are too noisy, both on screen and when exporting.

> when you use them, and then try to use pretty much any
> other Org feature on them (marking them as a TODO item, tagging, etc.)
> it doesn't work because lists aren't meant to be used that way.

True, but there are ways around that:

 - Instead of tagging, write the keywords after the item (use custom
 links or hooks to supress exporting)
 - Use visual-line-mode and search with multi occur.
 - use =#+TODO:= instead of todo keywords (and use multi occur).
 - To uniquely id items, add timestamps (and use multi occur).
 - Write a function to refile items (my hack is a bit idiosyncratic so I
 don't share it here, but it should be pretty straighforward using
 =(org-refile t)= to get the location).

-- 
Florian Beck

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

* Re: Valid use cases for lists?
  2015-08-19 19:32 Valid use cases for lists? Chris Patti
                   ` (2 preceding siblings ...)
  2015-08-19 21:02 ` Florian Beck
@ 2015-08-20 14:06 ` Matt Lundin
  3 siblings, 0 replies; 9+ messages in thread
From: Matt Lundin @ 2015-08-20 14:06 UTC (permalink / raw)
  To: Chris Patti; +Cc: emacs-orgmode

Chris Patti <cpatti@gmail.com> writes:

> Can anyone give me an example of when it's a good idea to use lists
> rather than headlines?
>
> They feel rather like a violation of the principle of least surprise
> to me, because when you use them, and then try to use pretty much any
> other Org feature on them (marking them as a TODO item, tagging, etc.)
> it doesn't work because lists aren't meant to be used that way.

> I'm guessing I'm missing something obvious here, and that's why I'm asking.

Lists are lists. Headlines are headlines. If you need something to show
up in an agenda view, use a headline. 

From the perspective of document structure, headlines vs. lists
corresponds with section headings vs. lists in Markdown:
https://en.wikipedia.org/wiki/Markdown#Example

I find lists to be a good means quickly to organize and reorganize items
within an entry. I use them for brainstorming, for making grocery lists,
for itemizing ingredients in recipes, for documenting what I did on a
task, etc.

Though you can't tag them or add todos to them, you can use checkboxes
to track your progress on items in a list.

 - http://orgmode.org/manual/Checkboxes.html#Checkboxes

Lists also play an important role in export. E.g., this list...

 - apples
   - Fuji
   - Red Delicious
 - bananas
 - pears

Exports to html as...

<ul class="org-ul">
<li>apples
<ul class="org-ul">
<li>Fuji</li>
<li>Red Delicious</li>
</ul></li>
<li>bananas</li>
<li>pears</li>
</ul>

Matt

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

* Re: Valid use cases for lists?
  2015-08-19 19:55 ` Rasmus
@ 2015-08-20 15:18   ` Mike McLean
  2015-08-21  3:59   ` Peter Salazar
  1 sibling, 0 replies; 9+ messages in thread
From: Mike McLean @ 2015-08-20 15:18 UTC (permalink / raw)
  To: Rasmus; +Cc: emacs-orgmode

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

On Wed, Aug 19, 2015 at 3:55 PM, Rasmus <rasmus@gmx.us> wrote:

> Chris Patti <cpatti@gmail.com> writes:
>
> > I'm guessing I'm missing something obvious here, and that's why I'm
> asking.
>
> Export.  List are used everywhere.
>

I also use them for “simple” projects. I have a set of Task TODO keywords
for one-off tasks. I have a set of Project TODO keywords for projects.
Typically a project is a heading with a Project keyword and a number of
(level + 1) headings with Task keywords. For projects that span several
days/weeks this works well.

Some things that I do fall between Project and Task in the complexity. The
items needs 1-2 things done and discrete and different points in time
(temporal dependency, first A then B) or with different co workers
(collaboration) or both. The overall work, however, will only take 0-2
days. It's too big for a single task. It's too small for a Project. It's
related items that conceptually belong together. In Goldilocks fashion, a
check-box list is just the right size.

#+begin_example
** TODO Medium Sized “project” [1/3]
- [X] Get information from John
- [ ] Process information and send to Mary for review
- [ ] Finalize and submit final to Joe (based on Mary’s comments and
changes)
#+end_example

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

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

* Re: Valid use cases for lists?
  2015-08-19 19:55 ` Rasmus
  2015-08-20 15:18   ` Mike McLean
@ 2015-08-21  3:59   ` Peter Salazar
  2015-08-21 18:39     ` Rasmus
  1 sibling, 1 reply; 9+ messages in thread
From: Peter Salazar @ 2015-08-21  3:59 UTC (permalink / raw)
  To: Rasmus; +Cc: org-mode

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

Export isn't a good reason to use lists over headings, since you can always
export headings as <li> lists if you want to, e.g. by setting number of
heading levels in export options. This doesn't mean plain text lists aren't
useful in org, it just means you don't need them to get lists in your
export format.

On Wed, Aug 19, 2015 at 3:55 PM, Rasmus <rasmus@gmx.us> wrote:

> Chris Patti <cpatti@gmail.com> writes:
>
> > I'm guessing I'm missing something obvious here, and that's why I'm
> asking.
>
> Export.  List are used everywhere.
>
> --
> The right to be left alone is a human right
>
>
>

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

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

* Re: Valid use cases for lists?
  2015-08-21  3:59   ` Peter Salazar
@ 2015-08-21 18:39     ` Rasmus
  2015-08-23 17:18       ` Peter Salazar
  0 siblings, 1 reply; 9+ messages in thread
From: Rasmus @ 2015-08-21 18:39 UTC (permalink / raw)
  To: emacs-orgmode

Peter Salazar <cycleofsong@gmail.com> writes:

> Export isn't a good reason to use lists over headings, since you can always
> export headings as <li> lists if you want to, e.g. by setting number of
> heading levels in export options. This doesn't mean plain text lists aren't
> useful in org, it just means you don't need them to get lists in your
> export format.

Semantically, lists are nicer.

Compare this is your org file.

* A very long item which you'd like to split over several lines A very long item which you'd like to split over several lines A very long item which you'd like to split over several lines A very long item which you'd like to split over several lines

  - A very long item which you'd like to split over several lines A very
    long item which you'd like to split over several lines A very long
    item which you'd like to split over several lines A very long item
    which you'd like to split over several lines


Which one do you prefer?


-- 
With monopolies the cake is a lie!

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

* Re: Valid use cases for lists?
  2015-08-21 18:39     ` Rasmus
@ 2015-08-23 17:18       ` Peter Salazar
  0 siblings, 0 replies; 9+ messages in thread
From: Peter Salazar @ 2015-08-23 17:18 UTC (permalink / raw)
  To: Rasmus; +Cc: org-mode

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

Agreed, plain-text lists are definitely preferable!

On Fri, Aug 21, 2015 at 2:39 PM, Rasmus <rasmus@gmx.us> wrote:

> Peter Salazar <cycleofsong@gmail.com> writes:
>
> > Export isn't a good reason to use lists over headings, since you can
> always
> > export headings as <li> lists if you want to, e.g. by setting number of
> > heading levels in export options. This doesn't mean plain text lists
> aren't
> > useful in org, it just means you don't need them to get lists in your
> > export format.
>
> Semantically, lists are nicer.
>
> Compare this is your org file.
>
> * A very long item which you'd like to split over several lines A very
> long item which you'd like to split over several lines A very long item
> which you'd like to split over several lines A very long item which you'd
> like to split over several lines
>
>   - A very long item which you'd like to split over several lines A very
>     long item which you'd like to split over several lines A very long
>     item which you'd like to split over several lines A very long item
>     which you'd like to split over several lines
>
>
> Which one do you prefer?
>
>
> --
> With monopolies the cake is a lie!
>
>
>

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

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

end of thread, other threads:[~2015-08-23 17:18 UTC | newest]

Thread overview: 9+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2015-08-19 19:32 Valid use cases for lists? Chris Patti
2015-08-19 19:55 ` Rasmus
2015-08-20 15:18   ` Mike McLean
2015-08-21  3:59   ` Peter Salazar
2015-08-21 18:39     ` Rasmus
2015-08-23 17:18       ` Peter Salazar
2015-08-19 20:00 ` Kyle Meyer
2015-08-19 21:02 ` Florian Beck
2015-08-20 14:06 ` Matt Lundin

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