From: Dmitry Gutov <dgutov@yandex.ru>
To: Stefan Monnier <monnier@iro.umontreal.ca>
Cc: emacs-devel@gnu.org
Subject: Re: ELPA commit freeze
Date: Thu, 22 Aug 2013 11:47:20 +0300 [thread overview]
Message-ID: <5215D018.70308@yandex.ru> (raw)
In-Reply-To: <jwvy57ulcig.fsf-monnier+emacs@gnu.org>
On 22.08.2013 04:55, Stefan Monnier wrote:
>> README.md also may be missing usage information that's in Commentary.
>> I've checked, and it's actually the case with all packages I'm
>> maintaining (except one, out of 6), whether I'm the author or not.
>
> 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.
>> 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.
>
> We can remove README.md from elpa/packages/company, if you prefer.
Of course I don't.
> Or we could just remove support for elpa/packages/*/README.md so that
> those files are systematically ignored.
That's what I was suggesting. Keep supporting plain README's, unlike
Melpa, as a backward compatibility measure, and because they're rare anyway.
If you're okay with that, I can make the change.
Note that I still like the idea of using README.md's for pages at
elpa.gnu.org/packages/*, but that can be implemented later.
next prev parent reply other threads:[~2013-08-22 8:47 UTC|newest]
Thread overview: 57+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-08-14 1:10 ELPA commit freeze Stefan Monnier
2013-08-14 7:46 ` Andreas Schwab
2013-08-14 14:42 ` Stefan Monnier
2013-08-15 1:12 ` Xue Fuqiao
2013-08-15 4:18 ` Stefan Monnier
2013-08-15 14:51 ` Eli Zaretskii
2013-08-15 15:29 ` Andreas Schwab
2013-08-15 15:44 ` Eli Zaretskii
2013-08-15 16:04 ` Andreas Schwab
2013-08-15 16:37 ` Eli Zaretskii
2013-08-15 16:42 ` Andreas Schwab
2013-08-15 17:06 ` Eli Zaretskii
2013-08-15 17:16 ` Eli Zaretskii
2013-08-20 18:20 ` Steinar Bang
2013-08-20 18:38 ` Eli Zaretskii
2013-08-21 7:06 ` Steinar Bang
2013-08-15 16:44 ` Stefan Monnier
2013-08-15 19:25 ` Glenn Morris
2013-08-15 20:33 ` Stefan Monnier
2013-08-15 20:41 ` Glenn Morris
2013-08-15 21:31 ` Stefan Monnier
2013-08-15 21:50 ` Glenn Morris
2013-08-14 9:56 ` Dmitry Gutov
2013-08-14 14:43 ` Stefan Monnier
2013-08-17 16:34 ` Dmitry Gutov
2013-08-19 2:39 ` Stefan Monnier
2013-08-19 6:31 ` Dmitry Gutov
2013-08-20 5:16 ` Stefan Monnier
2013-08-20 9:26 ` Dmitry Gutov
2013-08-20 9:40 ` Andreas Schwab
2013-08-20 13:42 ` Dmitry Gutov
2013-08-20 14:08 ` Andreas Schwab
2013-08-20 23:12 ` Dmitry Gutov
2013-08-20 14:45 ` Stefan Monnier
2013-08-20 23:22 ` Dmitry Gutov
2013-08-21 4:21 ` Stefan Monnier
2013-08-21 7:53 ` Dmitry Gutov
2013-08-21 19:56 ` Stefan Monnier
2013-08-21 23:38 ` Dmitry Gutov
2013-08-21 4:23 ` Stefan Monnier
2013-08-21 8:00 ` Dmitry Gutov
2013-08-21 20:00 ` Stefan Monnier
2013-08-21 21:51 ` Dmitry Gutov
2013-08-21 23:56 ` Stefan Monnier
2013-08-22 0:20 ` Dmitry Gutov
2013-08-22 1:55 ` Stefan Monnier
2013-08-22 8:47 ` Dmitry Gutov [this message]
2013-08-22 20:35 ` Stefan Monnier
2013-08-22 21:14 ` Dmitry Gutov
2013-08-23 0:51 ` Stefan Monnier
2013-08-23 1:28 ` Dmitry Gutov
2013-08-23 4:12 ` Stefan Monnier
2013-08-23 12:01 ` Dmitry Gutov
2013-08-23 15:05 ` Stefan Monnier
2013-08-24 1:16 ` Dmitry Gutov
-- strict thread matches above, loose matches on Subject: below --
2013-08-23 17:44 Donald Curtis
2013-08-23 23:04 ` Stefan Monnier
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=5215D018.70308@yandex.ru \
--to=dgutov@yandex.ru \
--cc=emacs-devel@gnu.org \
--cc=monnier@iro.umontreal.ca \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).