From mboxrd@z Thu Jan  1 00:00:00 1970
From: Texas Cyberthal <texas.cyberthal@gmail.com>
Subject: org-adapt-indentation default should be nil [legibility 3/6]
Date: Tue, 4 Feb 2020 12:09:10 +0800
Message-ID: <CAMUm490j7UfgntGk_zYOZ1NsgGkB4ra6ArxXu-xWt5S6_KBhFg@mail.gmail.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane-mx.org@gnu.org>
Received: from eggs.gnu.org ([2001:470:142:3::10]:47134)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <texas.cyberthal@gmail.com>) id 1iypX2-0005FA-NN
 for emacs-orgmode@gnu.org; Mon, 03 Feb 2020 23:09:49 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <texas.cyberthal@gmail.com>) id 1iypX1-0003dZ-Mg
 for emacs-orgmode@gnu.org; Mon, 03 Feb 2020 23:09:48 -0500
Received: from mail-ot1-x333.google.com ([2607:f8b0:4864:20::333]:46508)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <texas.cyberthal@gmail.com>)
 id 1iypX1-0003an-HA
 for emacs-orgmode@gnu.org; Mon, 03 Feb 2020 23:09:47 -0500
Received: by mail-ot1-x333.google.com with SMTP id g64so15812635otb.13
 for <emacs-orgmode@gnu.org>; Mon, 03 Feb 2020 20:09:47 -0800 (PST)
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane-mx.org@gnu.org
Sender: "Emacs-orgmode"
 <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane-mx.org@gnu.org>
To: "emacs-orgmode@gnu.org" <emacs-orgmode@gnu.org>

#+begin_src elisp
(org-adapt-indentation nil)
#+end_src

Adaptive indentation makes sense when using Org as a plain-text
database. It does not make sense when using Org for longform prose.

In the former case, outline depth is important to reflect properties
such as inheritance. The code elements are primary and the prose
secondary.

In the latter case, the primary payload is the prose. Gratuitously
indenting it wastes screen space and requires the user to make layout
adjustments for legibility. The extra information value of indentation
reflecting outline depth is negligible; the heading already conveys
it.

Beginners are bad at making adjustments to keep heavily-indented prose
legible. Thus the default should be nil.