[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: Fri, 23 Aug 2013 11:05:03 -0400
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux)

>> Currently your README.md contains nothing but a pointer to the webpage.
>> Clearly, it's not that important to include every one of those elements.
> When you see a pointer, you just follow it. Having a piece of text there
> would be different.

Ideally, the README would be a copy of the homepage, tho (and the same
text would be used for ELPA's and MELPA's readme.txt).  So you only
need to maintain one text, which is then copied to all places.

> But doesn't putting different information in different places make sense to
> you, at least on some level?

Hmm.... what an idea!?

> For example, http://elpa.gnu.org/packages/company.html includes the contents
> of NEWS.md, which looks great.
> It could similarly combine README.md and Commentary.

OK, that sounds promising, except I don't know how to combine them.
Could you define clearly "the division of work" between the two?
Or maybe we should just concatenate them and let the authors figure
out how to divide the work between the two?

One other issue is that Commentary does not have any markup, and I'd
like to use markup more actively (e.g. converting into HTML when
including it in packages/company.html, and rendering it on-the-fly in
[ Now, obviously we'd need a good on-the-fly rendering, which we don't
  have yet, so maybe the markup format won't be MarkDown anyway.  ]


reply via email to

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