emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Texas Cyberthal <texas.cyberthal@gmail.com>
To: "emacs-orgmode@gnu.org" <emacs-orgmode@gnu.org>
Subject: Re: org-adapt-indentation default should be nil [legibility 3/6]
Date: Wed, 5 Feb 2020 06:00:41 +0800	[thread overview]
Message-ID: <CAMUm493DWFFYG2ZEuAcEnFWG0ozLYcK4q67ZwcQT3B9hFG0HkA@mail.gmail.com> (raw)

> the default settings do not put blank lines between headings and their entry text,

I don't know what this means. Plain Emacs behaves the same way
Spacemacs does in this regard. Insertion of a blank line after a
heading is voluntary but standrd. Insertion of a blank line between
the current non-empty line and a new heading is automatic. The fact
that the latter looks nice tends to make users do the former.

> without any indentation, headings and entry text on varying levels tends to blend together, making for very poor readability.

If the goal is to read the body text of headings, then deeply
indenting it is contrary to the goal. If the goal is to see the depth
of headings, then the bodies should be folded. If folded mode doesn't
convey sufficient information, the solution is to rewrite the heading
titles to better summarize the body text.

I never use org-adapt-indentation and have no readability issues. Out
of curiosity, I tried to turn it on just now. There's no toggle for
it, even though it's a buffer-local variable. This suggests it's not
useful, since apparently nobody who's turned it off cares to turn it
on again.

> No one is "good at" Emacs and Org when they first come to it.

UI difficulty is exponential, not linear. The more initially difficult
the Emacs UI is acknowledged to be, the more important it is to reduce
that difficulty with noob-friendly defaults, so that they can
eventually reach the point of elitist unconcern for noobs.

The problem with aiming software at noobs is ruining the expert
experience. Changing defaults doesn't ruin expert experience because
experts have configuration management. Noob friendly defaults
increases the likelihood there is a long term for them. Emacs' biggest
barrier to adoption is acclimatization. I just read a GTD thread in
which they all agreed Org was too hard to be worth learning, including
the guy advocating it:

https://forum.gettingthingsdone.com/threads/emacs-org-mode-is-the-perfect-tool-for-gtd.15028/page-2

To be clear, this is the biggest GTD forum, which Org is the best
implementation of, and it seems most of them are using digital GTD
tools.

             reply	other threads:[~2020-02-04 22:01 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-02-04 22:00 Texas Cyberthal [this message]
2020-02-05 16:12 ` org-adapt-indentation default should be nil [legibility 3/6] Adam Porter
  -- strict thread matches above, loose matches on Subject: below --
2020-02-04  4:09 Texas Cyberthal
2020-02-04  7:21 ` Adam Porter
2020-02-10  7:05   ` Bastien
2020-02-10 20:33     ` Samuel Wales
2020-02-10 21:52       ` Bastien
2020-02-10 22:01         ` Samuel Wales

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=CAMUm493DWFFYG2ZEuAcEnFWG0ozLYcK4q67ZwcQT3B9hFG0HkA@mail.gmail.com \
    --to=texas.cyberthal@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    /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).