From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: ELPA commit freeze Date: Thu, 22 Aug 2013 16:35:53 -0400 Message-ID: References: <871u5w1tpy.fsf@yandex.ru> <520FA630.8080003@yandex.ru> <5211BBC8.40408@yandex.ru> <52133662.1000900@yandex.ru> <5213FA1C.3080700@yandex.ru> <52147393.9070509@yandex.ru> <5215364A.9000605@yandex.ru> <52155933.4080509@yandex.ru> <5215D018.70308@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1377203769 25480 80.91.229.3 (22 Aug 2013 20:36:09 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 22 Aug 2013 20:36:09 +0000 (UTC) Cc: emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Aug 22 22:36:12 2013 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 1VCbc3-0000lV-9M for ged-emacs-devel@m.gmane.org; Thu, 22 Aug 2013 22:36:11 +0200 Original-Received: from localhost ([::1]:33713 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VCbc2-0007cZ-Tw for ged-emacs-devel@m.gmane.org; Thu, 22 Aug 2013 16:36:10 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37848) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VCbbv-0007bS-Pd for emacs-devel@gnu.org; Thu, 22 Aug 2013 16:36:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VCbbn-0004si-Tt for emacs-devel@gnu.org; Thu, 22 Aug 2013 16:36:02 -0400 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.182]:32040) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VCbbn-0004sM-Ny for emacs-devel@gnu.org; Thu, 22 Aug 2013 16:35:55 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av4EABK/CFHO+LNT/2dsb2JhbABEvw4Xc4IeAQEEAVYjEAsOJhIUGA0kiB4GwS2RCgOXKY1RgV6DEw X-IPAS-Result: Av4EABK/CFHO+LNT/2dsb2JhbABEvw4Xc4IeAQEEAVYjEAsOJhIUGA0kiB4GwS2RCgOXKY1RgV6DEw X-IronPort-AV: E=Sophos;i="4.84,565,1355115600"; d="scan'208";a="23015541" Original-Received: from 206-248-179-83.dsl.teksavvy.com (HELO pastel.home) ([206.248.179.83]) by ironport2-out.teksavvy.com with ESMTP/TLS/ADH-AES256-SHA; 22 Aug 2013 16:35:47 -0400 Original-Received: by pastel.home (Postfix, from userid 20848) id D6F0D6627C; Thu, 22 Aug 2013 16:35:53 -0400 (EDT) In-Reply-To: <5215D018.70308@yandex.ru> (Dmitry Gutov's message of "Thu, 22 Aug 2013 11:47:20 +0300") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 206.248.154.182 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:162982 Archived-At: >> Why couldn't that be fixed? Why should usage info not be in README.md? > Because it's customary to put at least something into Commentary, usage info > seems to be the most natural info to put there, and duplicating text is not > nice. See my previous emails for better arguments. OK. let's try to take a step back. You're suggesting that we need 2 places where we put different info (one being the Commentary: and another being the README.*). I just don't see it. If you want to put info in the README, then you can put all the relevant info in the README, and the Commentary: can be trivial. And vice versa. >>> Take company's README.md, for example. It's barren, but Commentary in >>> company.el contains what you'd expect from a description. I'd like to keep >>> things that way there. Why? Why not move the info from company.el to README.md (where it can be made prettier while you're at it)? Stefan