From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Trunk still not open Date: Mon, 17 Mar 2014 18:43:05 +0200 Message-ID: <838us8bwti.fsf@gnu.org> References: <6xwqfxhl88.fsf@fencepost.gnu.org> <83txb1mcsy.fsf@gnu.org> <87siqlku0i.fsf@uwakimon.sk.tsukuba.ac.jp> <87wqfxari2.fsf@yandex.ru> <87ha70kyy3.fsf@uwakimon.sk.tsukuba.ac.jp> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1395074589 27073 80.91.229.3 (17 Mar 2014 16:43:09 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 17 Mar 2014 16:43:09 +0000 (UTC) Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Lars Magne Ingebrigtsen Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Mar 17 17:43:17 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1WPadA-000876-Db for ged-emacs-devel@m.gmane.org; Mon, 17 Mar 2014 17:43:16 +0100 Original-Received: from localhost ([::1]:59081 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPadA-0007l3-06 for ged-emacs-devel@m.gmane.org; Mon, 17 Mar 2014 12:43:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41004) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPad1-0007jz-81 for emacs-devel@gnu.org; Mon, 17 Mar 2014 12:43:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WPacv-0005uG-AG for emacs-devel@gnu.org; Mon, 17 Mar 2014 12:43:07 -0400 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:62960) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPacv-0005tz-2O for emacs-devel@gnu.org; Mon, 17 Mar 2014 12:43:01 -0400 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0N2L00400AB16600@a-mtaout22.012.net.il> for emacs-devel@gnu.org; Mon, 17 Mar 2014 18:42:59 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N2L00421AFN3430@a-mtaout22.012.net.il>; Mon, 17 Mar 2014 18:42:59 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.172 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:170449 Archived-At: > From: Lars Magne Ingebrigtsen > Date: Mon, 17 Mar 2014 16:13:29 +0100 > Cc: emacs-devel@gnu.org > > Being able to add functionality and get feedback on it fast is very > valuable. Writing in-depth documentation for stuff that will likely > change is wasted time. Deferring documentation for later is a sure recipe to get back where we are now. For starters, who will remember to get back to writing docs afterwards (or want to, for that matter)? Who will manage the queue, and how? etc/NEWS again? We know where that leads. > The other thing is that I kinda feel that we're over-documenting some > things. I think things should just work without the user having to read > documentation at all. And Emacs has some methods for discoverability > (like 'C-h m') that work quite well if you're looking for what commands > are available. I think we already document only what needs to be, see the "---" markers in NEWS. > Not all modes need an entry in the Emacs and Lispref manuals. Neither are they.