[Python-Dev] Move selected documentation repos to PSF BitBucket account?

[Georg Brandl]

On 11/24/2014 12:21 AM, Brett Cannon wrote:
> 
> 
> On Sun Nov 23 2014 at 4:18: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