From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bastien Guerry Subject: Re: [RFC] Moving "manual.org" into core Date: Tue, 06 Mar 2018 02:08:49 +0100 Message-ID: <87r2oy57tq.fsf@bzg.fr> References: <87bmhooaj9.fsf@nicolasgoaziou.fr> <87y3j8dw45.fsf@bzg.fr> <87lgf8f93b.fsf@nicolasgoaziou.fr> <87lgf89lro.fsf@gnu.org> <87k1uq4n90.fsf@nicolasgoaziou.fr> <87k1uql7it.fsf@tsdye.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:47410) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1et168-0001HD-7l for emacs-orgmode@gnu.org; Mon, 05 Mar 2018 20:08:57 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1et164-0004hz-Vp for emacs-orgmode@gnu.org; Mon, 05 Mar 2018 20:08:56 -0500 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: "Thomas S. Dye" Cc: Glenn Morris , Achim Gratz , Org Mode List , Nicolas Goaziou Hi Thomas and all, please, let's take a deep breath and let me try to explain myself as clearly as possible. And remember english is not my first language, so sometimes I may not express myself in the most adequate manner. First, let me just restate this clearly: I am in favor of editing the manual.org version instead of org.texi and I am in favor of doing it as a 1-year experiment, to see how it goes, and I'm in favor of moving forward as quickly as reasonable here. But Org is not an island: Org is part of Emacs and Emacs documentation is written in Texinfo. This move is not a small one and I agree with Glenn that it is worth discussing it to the Emacs mailing list before we make the switch. I assume the delay it may take. "Discussing it" is not a hidden plan for not doing it :) It is just a way of collecting thoughts from the Emacs community. Also, please accept my apologies if I hurt your feelings when I said: "To speak the truth, I first thought migrating to org as the preferred format for editing the manual was just a bad idea." "Bad" was too harsh and too simplistic. What I thought was more this: editing manual.org instead of org.texi can be very nice indeed, but it goes in the opposite direction of one of the goals I've set for Org's code, which is to be directly edited from within Emacs repo at some point, as Gnus does today. If we make the switch -- and I want to make it! -- we won't be able to merge Org's code into Emacs repo anytime soon. So, to put things in perspective: - You started the project in 2013: https://github.com/tsdye/orgmanual - Someone resurrected it on the list in 2016: http://article.gmane.org/gmane.emacs.orgmode/107141 - Nicolas made a giant leap forward and announced it was ready last December. I never expressed myself negatively about this experiment because this is how I saw it: a very nice experiment! I was amazed at what you did in 2013 the same way I'm amazed at what Nicolas did last year, because this is truly a great achievement. Maybe this is where some misunderstanding arose: to me, there was no _project_ to migrate to manual.org -- it was an idea in the air after you made your experiment and we now have the decision at hand because the project is, well, DONE. We could have done it another way: we could have discussed it as a project, then anticipated that it will prevent Org's code to migrate to Emacs repository, then discussed the pros and cons before investing more time. Anyway, here we are, I think it is safe to assume that editing an .org version of the manual will help us write better documentation within a year than to assume that Org's code will migrate into Emacs repository within a year -- so let's celebrate the achievement by moving forward! Let's just mention this on emacs-devel first. And I hope my point of view is a bit more clear. Thanks! -- Bastien