Skip to content

Link to developer guide in CPython repo description #30

Description

@ncoghlan

python/cpython#118 adds a link to the Developer Guide to the top of the README.

It would be useful if the repo description linked to the developer guide in addition to linking to the main python.org website.

Activity

  1. brettcannon commented on Feb 15, 2017

    @brettcannon
    Member

    There's no good way to provide two links in the repo title as that link is a specific, separate field from the description.

  2. ncoghlan commented on Feb 18, 2017

    @ncoghlan
    ContributorAuthor

    In that case, I'll rephrase the proposal to suggest linking to the developer guide instead of linking to python.org :)

  3. brettcannon commented on Feb 24, 2017

    @brettcannon
    Member

    The question becomes what do people use that link for? I personally use it to validate that I'm looking at the project that's behind a certain website or to get to the homepage quickly, not to get to developer documentation. I always assume the README and/or CONTRIBUTING files will have the dev doc links.

  4. Mariatta commented on Feb 24, 2017

    @Mariatta
    Member

    🤔 Maybe instead of www.python.org, it should be pointing to docs.python.org?
    It is part of cpython repo

  5. brettcannon commented on Feb 24, 2017

    @brettcannon
    Member

    I think we are all way over-thinking a single link 😉 . Maybe it would be better to just have 3 quick links listed at the top of the README: www.python.org, docs.python.org, and the devguide.

  6. Mariatta commented on Feb 25, 2017

    @Mariatta
    Member

    Sounds good to me :)
    Please see my proposed PR at python/cpython#283

  7. ncoghlan commented on Feb 25, 2017

    @ncoghlan
    ContributorAuthor

    @Mariatta's addition looks good to me, and should be useful to folks looking at the README offline as well.

    As far as the project level link goes, I think the reason it bugs me is just because our top level directory and file listing is long enough to push the start of the README off the bottom of the page. And yes, I'm almost certainly overthinking it :)

  8. brettcannon commented on Feb 27, 2017

    @brettcannon
    Member

    Since Mariatta's proposed PR was merged I'm closing this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions