<div dir="ltr">One thought that comes to mind is how to present specs that deal with formats and artifacts that persist for years.<div><br></div><div>For example, down the road when there's Wheel 2.0, what's the "Current Specs" for wheel?</div><div><br></div><div>I would describe 2.0 is the "Latest" spec, but "Current Specs" includes all versions we're attempting to support, so we'd want the "Current Specs" page to easily show all the versions, and not have to dig them out from version control or something, right?<br><div><br></div></div><div>--Marcus</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Sat, Sep 5, 2015 at 1:35 AM, Nick Coghlan <span dir="ltr"><<a href="mailto:ncoghlan@gmail.com" target="_blank">ncoghlan@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 5 September 2015 at 16:46, Nathaniel Smith <<a href="mailto:njs@pobox.com">njs@pobox.com</a>> wrote:<br>
> On Fri, Sep 4, 2015 at 9:24 PM, Marcus Smith <<a href="mailto:qwcode@gmail.com">qwcode@gmail.com</a>> wrote:<br>
>>> I don't have a specific problem with the specs living somewhere else<br>
>>> as well, I just don't think moving a lengthy document full of edge cases<br>
>>> from one location to another is going to make things better<br>
>><br>
>> If I may, I don't think that really captures Nick's idea.<br>
>><br>
>> I think it's about clearly distinguishing the following:<br>
>><br>
>> 1) Current Specs (for metadata, versioning, pypi etc..)<br>
>> 2) Proposals to adjust or add to the Current Specs<br>
>><br>
>> We don't have a clear distinction right now.   We just have a series of<br>
>> PEPs, and it's work to figure out where the actual current spec is at, in<br>
>> the noise of rationales and transition plans etc...<br>
><br>
> Speaking as someone who has been pretty confused in the past trying to<br>
> look up what the actual current rules are for something like version<br>
> numbers or metadata (is this the current PEP? oh wait this one's newer<br>
> -- oh but wait is the newer one still in development? or maybe<br>
> abandoned?, etc.): +1<br>
<br>
</span>We also have specs like Tarek's database of installed distributions<br>
(<a href="https://www.python.org/dev/peps/pep-0376/" rel="noreferrer" target="_blank">https://www.python.org/dev/peps/pep-0376/</a>), where we kept the<br>
"dist-info" parts, but not any of the API proposals.<br>
<br>
*Existing* formats (like sdist) could also be specified there without<br>
requiring a new PEP (modulo people's time to do the work, but at least<br>
having a place for such specs to *go* would be a good first step).<br>
<div class="HOEnZb"><div class="h5"><br>
Cheers,<br>
Nick.<br>
<br>
--<br>
Nick Coghlan   |   <a href="mailto:ncoghlan@gmail.com">ncoghlan@gmail.com</a>   |   Brisbane, Australia<br>
</div></div></blockquote></div><br></div>