[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: ELPA commit freeze

From: Stefan Monnier
Subject: Re: ELPA commit freeze
Date: Thu, 22 Aug 2013 16:35:53 -0400
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux)

>> 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)?


reply via email to

[Prev in Thread] Current Thread [Next in Thread]