[Python-Dev] Move selected documentation repos to PSF BitBucket account?
Donald Stufft
donald at stufft.io
Fri Nov 21 22:36:00 CET 2014
> On Nov 21, 2014, at 3:59 PM, Ned Deily <nad at acm.org> wrote:
>
> In article <19336614-0E4F-42BF-A918-1807BB7F3599 at stufft.io>,
> Donald Stufft <donald at stufft.io> wrote:
> [...]
>> Well you can’t document your way out of a bad UX. The thing you’re
>> competing with (on Github at least) is:
>>
>> 1. I notice a docs change I can make
>> 2. I click the “Edit” button and it automatically creates a fork,
>> and opens up a web based editor where I can make changes to
>> that file.
>> 3. I fill out the commit message and hit Save.
>> 4. An automatic pull request is opened up with my changes.
>>
>> I can submit a fix for a typo in the docs in like ~30 seconds assuming
>> I already have a Github account. That sort of instant win is a great
>> way to get people started contributing to a project and can lead later
>> to bigger more substantial contributions.
> [...]
>> Mostly what I’m trying to say is that documenting a field that essentially
>> requires
>> the end user to not only figure out how to use mercurial, but figure out how
>> to
>> host a public repository somewhere is not even really within the same order
>> of
>> magnitude in ease of use.
>
> Sure, I get that. But we're not even talking here about the main Python
> docs since they are part of the CPython repos, only ancillary repos like
> PEPs and the developer's guide. The level of activity on those is quite
> small. So, thinking about it a bit more, PEPs don't normally have bug
> tracker issues associated with them so I suppose my concerns about issue
> tracker aren't a major concern for them. The dev guide does get issues
> opened about it and I suppose they could be managed. But, without
> tackling the CPython repo workflow (a *much* bigger deal), is the
> divergence in workflows worth it? I dunno.
Yea for the smaller repositories I don’t have a whole lot of opinion
about if the benefit buys us much, especially since one of the goals
is new-person friendliness but the problem is that it doesn’t translate
to contributing to CPython itself.
---
Donald Stufft
PGP: 7C6B 7C5D 5E2B 6356 A926 F04F 6E3C BCE9 3372 DCFA
More information about the Python-Dev
mailing list