How to organize tasks about Worg within Worg documents (was: Re: [Worg] CSS improvements)

[Adam Porter]

On 3/29/24 04:48, Ihor Radchenko wrote:

> > > Also, we may consider re-using inlinetask style for TODO: entries.
> > >
> > > Rather than
> > > #+begin_center
> > > TODO: Even better, find a volunteer to maintain this information!
> > > #+end_center
> > >
> > > We can do
> > >
> > > **************************** TODO Even better, ...
> >
> > That is a lot of asterisks, and I can't remember if inline tasks are
> > enabled by default.  :)  But in general, sure, I've no objection.  I
> > think that we should have some standard way to encode tasks within Worg
> > documents, regardless of what it is.
>
> Yeah. And... we do.
> https://orgmode.org/worg/worg-editing.html#orgce51883
>
> Just a normal heading with TODO keyword.

I'm not sure that page really covers the question of how to present 
tasks about the document within the same document.

Using a normal heading for a task would "commandeer" the structure of 
the document, which I think is a real problem.

ISTM that there are a few potential solutions:

a. Using inline tasks.  Although not enabled by default, they seem to
   solve the problem pretty well.

b. Using commented lines, i.e.

     # TODO: Improve this information.

   Potentially we could even comment Org syntax within the file, like:

     # * TODO Improve this information  :research_needed:

   Which encodes a normal Org heading but as a commented line, so it    
   wouldn't affect the structure of the document itself.  Of course,
   that would not appear in the exported content, which is probably not
   what we want; but those headings could still be collected, e.g. by
   something like magit-todos.

c. Keeping tasks in a separate file.  We do already have the /todo.org
   file, so maybe this is what we should standardize on, i.e. never
   putting tasks in the documents themselves but only in this file.

Regardless of the decision, I do think that having this stated as a 
policy somewhere would be helpful.

WDYT?