[Python-Dev] Move selected documentation repos to PSF BitBucket account? (original) (raw)

Georg Brandl g.brandl at gmx.net
Mon Nov 24 00:36:13 CET 2014

On 11/24/2014 12:21 AM, Brett Cannon wrote:

On Sun Nov 23 2014 at 4🔞37 PM Georg Brandl <g.brandl at gmx.net_ _<mailto:g.brandl at gmx.net>> wrote: On 11/23/2014 09:42 PM, Brett Cannon wrote: [SNIP] > > And I'm still in support no matter what of breaking out the HOWTOs and the > > tutorial into their own repos for easier updating (having to update the Python > > porting HOWTO in three branches is a pain when it should be consistent across > > Python releases). > > I see no problem with that, provided there's a cronjob that syncs the version > in Doc/ to the external version reasonably often. > > > Would that really be necessary? At least for the HOWTOs how often are they > edited simultaneously as some code in CPython? The Clinic HOWTO is probably the > only one that might get updated simultaneously. I'd also be curious to know how > often the tutorial is updated simultaneously as well. I'd like the HOWTOs to stay part of Doc/, so changes in the external repo have to be merged in there somehow, and not only at release time. Right, I'm trying to understand why you want the HOWTOs to stay in Doc/. I dread having to update the porting HOWTO because it requires updating 2.7, 3.4, and default. And if the process is automated to pull from an external repo then what is the benefit of syncing the files and duplicating them across 4 repos?

That they are still part of the docs on docs.python.org and what people download from there. I don't like resources like that scattered about. It makes sense for the devguide, since that is really a different topic.

Georg

More information about the Python-Dev mailing list