On 5 September 2015 at 14:24, Marcus Smith <qwc...@gmail.com> wrote:
>> I don't have a specific problem with the specs living somewhere else>> as well, I just don't think moving a lengthy document full of edge cases>> from one location to another is going to make things better>> If I may, I don't think that really captures Nick's idea.
Right, having more user friendly introductions on packaging.python.org
is a good idea, but it's a separate question. To address that specific
problem, we can paraphrase the semantic versioning compatibility
section from PEP 440:
https://www.python.org/dev/peps/pep-0440/#semantic-versioning
I filed a PR along those lines, inserting it as a new subsection under
"Configuring your project"
> I think it's about clearly distinguishing the following:>> 1) Current Specs (for metadata, versioning, pypi etc..)> 2) Proposals to adjust or add to the Current Specs>> We don't have a clear distinction right now. We just have a series of> PEPs, and it's work to figure out where the actual current spec is at, in> the noise of rationales and transition plans etc...>> - So, for #1, maintain documents in PyPUG> - For #2, keep using PEPs> - As PEPs are accepted, update the Spec docs (the version history can> mention what PEP drove the change)
Right. Another potential benefit of this approach is that it means we
can more easily cross-link from the implementor facing specifications
to end user facing parts of the user guide - at the moment, there's no
standard discoverability path from PEPs like PEP 440 to
packaging.python.org at all.
Cheers,
Nick.
--
Nick Coghlan | ncog...@gmail.com | Brisbane, Australia
_______________________________________________
Distutils-SIG maillist - Dist...@python.org
https://mail.python.org/mailman/listinfo/distutils-sig
Recent Messages in this Thread |
|
Nate Coraor |
Jul 16, 2015 05:41 pm |
|
Nick Coghlan |
Sep 06, 2015 11:32 pm |
|
Nick Coghlan |
Sep 05, 2015 02:56 am |
|
Marcus Smith |
Sep 07, 2015 04:11 am |
|
Nate Coraor |
Sep 03, 2015 05:22 pm |
|
Nick Coghlan |
Sep 07, 2015 04:26 am |
|
Daniel Holth |
Aug 20, 2015 07:22 pm |
|
Donald Stufft |
Aug 20, 2015 07:25 pm |
|
Donald Stufft |
Sep 02, 2015 11:45 pm |
|
Daniel Holth |
Sep 03, 2015 12:15 pm |
|
Nate Coraor |
Aug 24, 2015 03:03 pm |
|
Wes Turner |
Aug 24, 2015 05:51 pm |
|
Nick Coghlan |
Jul 17, 2015 08:22 am |
|
Chris Barker |
Jul 17, 2015 03:36 pm |
|
Antoine Pitrou |
Jul 17, 2015 03:46 pm |
|
Chris Barker |
Jul 17, 2015 03:53 pm |
|
Andrea Bedini |
Jul 18, 2015 07:00 am |
|
Tres Seaver |
Jul 21, 2015 03:25 am |
|
Leonardo Rochael Almeida |
Jul 21, 2015 03:07 pm |
|
Marcus Smith |
Jul 17, 2015 04:50 pm |
|
Olivier Grisel |
Jul 17, 2015 06:34 pm |
|
Daniel Holth |
Jul 17, 2015 08:18 pm |
|
Chris Barker - NOAA Federal |
Jul 18, 2015 01:13 am |
|
Daniel Holth |
Jul 18, 2015 02:11 am |
|
Paul Moore |
Jul 18, 2015 11:51 am |
|
Nick Coghlan |
Jul 20, 2015 05:50 am |
|
Chris Barker |
Jul 20, 2015 05:37 pm |
|
Paul Moore |
Jul 20, 2015 06:37 pm |
|
Nick Coghlan |
Jul 27, 2015 02:19 pm |
|
Nate Coraor |
Jul 27, 2015 07:07 pm |
|
Oscar Benjamin |
Jul 21, 2015 04:38 pm |
|
Chris Barker |
Jul 24, 2015 06:52 pm |
|
Oscar Benjamin |
Jul 28, 2015 03:02 pm |
|
Wes Turner |
Jul 28, 2015 04:21 pm |
|
Nate Coraor |
Aug 12, 2015 08:21 pm |
|
Robert Collins |
Aug 12, 2015 11:49 pm |
|
Nathaniel Smith |
Aug 13, 2015 01:05 am |
|
Nate Coraor |
Aug 13, 2015 02:07 pm |
|
Leonardo Rochael Almeida |
Aug 13, 2015 07:30 pm |
|
Wes Turner |
Aug 13, 2015 07:43 pm |
|
Nathaniel Smith |
Aug 14, 2015 01:47 am |
|
Wes Turner |
Aug 14, 2015 01:50 am |
|
Nathaniel Smith |
Aug 14, 2015 02:33 am |
|
Wes Turner |
Aug 14, 2015 02:41 am |
|
Leonardo Rochael Almeida |
Sep 08, 2015 07:18 pm |
|
Donald Stufft |
Sep 08, 2015 07:22 pm |
|
Leonardo Rochael Almeida |
Sep 08, 2015 07:39 pm |
|
Nathaniel Smith |
Aug 14, 2015 01:25 am |
|
Robert Collins |
Aug 14, 2015 01:31 am |
|
Wes Turner |
Aug 14, 2015 01:38 am |
|
Robert Collins |
Aug 14, 2015 01:44 am |
|
Wes Turner |
Aug 14, 2015 01:44 am |
|
Nathaniel Smith |
Aug 14, 2015 02:14 am |
|
Wes Turner |
Aug 14, 2015 02:24 am |
|
Robert Collins |
Aug 14, 2015 02:27 am |
|
Nathaniel Smith |
Aug 14, 2015 07:38 am |
|
David Cournapeau |
Aug 13, 2015 05:52 pm |
|
Nathaniel Smith |
Aug 14, 2015 04:07 am |
|
Chris Barker |
Aug 14, 2015 04:04 pm |
|
David Cournapeau |
Aug 14, 2015 04:20 pm |
|
Chris Barker |
Aug 14, 2015 04:00 pm |
|
Leonardo Rochael Almeida |
Jul 20, 2015 01:42 am |
|
Nick Coghlan |
Jul 20, 2015 06:00 am |
|
Chris Barker |
Jul 20, 2015 05:39 pm |
|
Marcus Smith |
Sep 06, 2015 04:09 pm |
|
Nick Coghlan |
Sep 05, 2015 08:35 am |
|
Nick Coghlan |
Sep 05, 2015 06:44 am |
Re: [Distutils] Working toward Linux wheel support |
Nick Coghlan |
Sep 05, 2015 06:43 am |
|
Nathaniel Smith |
Sep 05, 2015 06:46 am |
|
Donald Stufft |
Sep 05, 2015 03:06 am |
|
Wes Turner |
Sep 08, 2015 07:14 pm |
|
Daniel Holth |
Sep 08, 2015 07:32 pm |
|
Nathaniel Smith |
Sep 09, 2015 11:49 pm |
|
Nate Coraor |
Sep 21, 2015 03:33 pm |
|
Nate Coraor |
Sep 09, 2015 03:06 pm |
|
Donald Stufft |
Sep 08, 2015 06:33 pm |
|
Donald Stufft |
Sep 07, 2015 04:02 pm |
|
Marcus Smith |
Sep 07, 2015 05:51 pm |
|
Wes Turner |
Sep 07, 2015 10:16 pm |
|
Nate Coraor |
Sep 03, 2015 02:04 pm |
|
Daniel Holth |
Sep 03, 2015 01:56 pm |
|
Antoine Pitrou |
Aug 20, 2015 07:51 pm |
|
Nate Coraor |
Aug 20, 2015 07:40 pm |
|
Donald Stufft |
Aug 20, 2015 07:19 pm |
|
Antoine Pitrou |
Aug 20, 2015 07:14 pm |
|
Steve Dower |
Aug 14, 2015 04:17 pm |
|
Daniel Holth |
Aug 20, 2015 06:38 pm |
|
Chris Barker |
Aug 14, 2015 08:16 pm |
|
Alexander Walters |
Aug 14, 2015 10:32 pm |
|
Nate Coraor |
Aug 20, 2015 06:26 pm |
|
Nick Coghlan |
Sep 05, 2015 02:12 am |
|
Daniel Holth |
Sep 01, 2015 01:57 pm |
|
Wes Turner |
Aug 26, 2015 01:42 am |
|
Nate Coraor |
Aug 27, 2015 07:21 pm |
|
Ben Finney |
Sep 06, 2015 11:42 pm |