From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lars Magne Ingebrigtsen Newsgroups: gmane.emacs.devel Subject: Re: Trunk still not open Date: Mon, 17 Mar 2014 16:13:29 +0100 Message-ID: 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> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1395069282 22955 80.91.229.3 (17 Mar 2014 15:14:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 17 Mar 2014 15:14:42 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Mar 17 16:14:51 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 1WPZFb-0000Ps-9M for ged-emacs-devel@m.gmane.org; Mon, 17 Mar 2014 16:14:51 +0100 Original-Received: from localhost ([::1]:58522 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPZFa-0001z3-RW for ged-emacs-devel@m.gmane.org; Mon, 17 Mar 2014 11:14:50 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39983) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPZEj-00013d-Sd for emacs-devel@gnu.org; Mon, 17 Mar 2014 11:14:03 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WPZEe-0006aB-C9 for emacs-devel@gnu.org; Mon, 17 Mar 2014 11:13:57 -0400 Original-Received: from hermes.netfonds.no ([80.91.224.195]:58717) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WPZEe-0006XO-5r for emacs-devel@gnu.org; Mon, 17 Mar 2014 11:13:52 -0400 Original-Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WPZEI-0007CR-38; Mon, 17 Mar 2014 16:13:30 +0100 Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAFVBMVEW+NUknAhLsVVb2klyR ID5UDCnWRVJ8b54EAAACVElEQVQ4jVWTwW7jMAxEWa+ju4D13ZBanVPLm7Na0D3HhXkX1ED//wk7 lBNnVwe30MtwhqRNIoMIJ2Z/idFF5yMOM5OCDf8k7+I0dTt4ZbkDaFzBHZUGRl5oWAEWYTbVoYZp IAOIFREFn6bEKSU/NYXQOiwKNiiKd5y65tGrBw48mIxzVUMAvAkABHKFeTUh50Tpl9/BpopNUClX 6hOhlI/jaslqqmZBpt5SQTQ3LQCaals4EVF1497gJGJpBYAl95zgPjkNFURWKAbWA6fUte5ivImm 2oHowL5weUZe1lJi7UY6RJPROnrr/Lg0j01gbFzJlDDBCdVe7wDXtdbO3VL12EicXmEx0NbFjObQ 2Kzgp20DsyPuKZlAS/KzoZ8GzgBIlZhKIJavZKjETRP3DWxkSqgoNRIeTkd1gYS2pPN2GMVZAU6p Uw8FExXXJhQCVQWXHLQUj1h2Ay6Y+8ZTUhBqKxQnF2rVv5Nr5lRruQNXqaXt3mQHuwLPDDD7+do1 QKrQvbmxTwDjH+HlUDiPSjcExKRuVhrQtO0EFccLfWNSAOkArkersJbZsirMATLTpz9dX75vvA76 bhxAO38bsk2LtZQeIIRctZvT9WRxyNTn77XNnD7WBg7vqt9HvJyw7x3cFcG1Nme29n+ANvTjWOwD pHKvlRd939YnMEdag0r2AP0jVhvl+xNkyrgKeh2qf3mC2jp5bGv9FyBXcbW0L2Odv4S3mXkl1NJX t607Rqs9bnh84FZ3VfdvYNrLDM28NgnG759pf6NUJfy6hkwEkyOtrH8Btpng/JwCOTgAAAAASUVO RK5CYII= X-Now-Playing: Robert Wyatt's _'68_: "Moon In June" In-Reply-To: (Stefan's message of "Mon, 17 Mar 2014 10:32:42 -0400") User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) X-MailScanner-ID: 1WPZEI-0007CR-38 MailScanner-NULL-Check: 1395674010.577@7BGC9y2xFKtRyW9SmZVvUw X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 80.91.224.195 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:170440 Archived-At: Stefan writes: > FWIW, while I suck both at writing documentation and at forcing myself > to write documentation, I'm in favor of being more strict > w.r.t documentation. But in many cases, code is installed in > a non-definitive way, so it's convenient to install the code first, then > fix up some of it based on user's feedback and only later write the doc. > That saves us the time of documenting the intermediate state. I agree. 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. 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. Not all modes need an entry in the Emacs and Lispref manuals. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no