From mboxrd@z Thu Jan  1 00:00:00 1970
From: Nicolas Goaziou <mail@nicolasgoaziou.fr>
Subject: Re: [RFC] Dog food, anyone?
Date: Tue, 19 Dec 2017 20:25:15 +0100
Message-ID: <87r2rqjzac.fsf@nicolasgoaziou.fr>
References: <87efntod73.fsf@nicolasgoaziou.fr> <m2mv2foilb.fsf@tsdye.com>
	<87efnrlml3.fsf@nicolasgoaziou.fr> <m2k1xjo9sk.fsf@tsdye.com>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:52149)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1eRNW0-0000Lm-SR
	for emacs-orgmode@gnu.org; Tue, 19 Dec 2017 14:25:25 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@nicolasgoaziou.fr>) id 1eRNVw-0007G0-2C
	for emacs-orgmode@gnu.org; Tue, 19 Dec 2017 14:25:24 -0500
Received: from relay4-d.mail.gandi.net ([217.70.183.196]:59713)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <mail@nicolasgoaziou.fr>)
	id 1eRNVv-0007Es-RK
	for emacs-orgmode@gnu.org; Tue, 19 Dec 2017 14:25:19 -0500
In-Reply-To: <m2k1xjo9sk.fsf@tsdye.com> (Thomas S. Dye's message of "Mon, 18
	Dec 2017 14:12:27 -1000")
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: <http://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.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: "Thomas S. Dye" <tsd@tsdye.com>
Cc: Org Mode List <emacs-orgmode@gnu.org>

Hello,

"Thomas S. Dye" <tsd@tsdye.com> writes:

> I find the en-dash with spaces more aesthetically pleasing, too.

Unfortunately, Emacs manual thoroughly uses em-dash. We have to bite the
bullet, IMO.

I will change " -- " into "---" if there is no objection.

> Agreed. This is one of the first things we might do if manual.org
> becomes the official source of the Org manual.
>
> FYI, Phil Rooke's Documentation_Standards.org suggests title case for
> chapter heads and sentence case for section and subsection headings.

OTOH, Emacs manual seems to use title case at every level, barring some
exceptions (e.g., "Terminal emulator").

Maybe we should stick to title case to every heading that belong to
a menu, i.e., we can use sentence case for "notoc" headings.

Since Texinfo node names are derived from headlines, it means external
references to Org manual, if such thing exists, are going to break.

WDYT?

Regards,

-- 
Nicolas Goaziou