Refresh some of the information on the codebase docs.

Review Request #6863 — Created Jan. 31, 2015 and submitted

Information

Review Board
master
3c713f6...

Reviewers

This fixes up some of the docs to be a bit more modern and to get rid of
old, misleading information.

The Contributing Patches documentation has been updated to talk about
release branches and pull requests.

URLs have been updated throughout the docs to use HTTPS instead of HTTP
when applicable.

Built the docs. Things looked okay.

Description From Last Updated

Maybe we should mention what the appropriate branch is - like, make it clear that we have a branch that …

mike_conleymike_conley

Would it be worth mentioning clear-pycs here?

mike_conleymike_conley

Is there a place where we could stash the currently maintained major and minor release numbers so that we have …

mike_conleymike_conley
reviewbot
  1. Tool: PEP8 Style Checker
    Ignored Files:
        docs/codebase/custom-forks.rst
        docs/codebase/index.rst
        docs/codebase/contributing-patches.rst
        docs/codebase/unit-tests/fixtures.rst
        docs/codebase/getting-started.rst
    
    
    
    Tool: Pyflakes
    Ignored Files:
        docs/codebase/custom-forks.rst
        docs/codebase/index.rst
        docs/codebase/contributing-patches.rst
        docs/codebase/unit-tests/fixtures.rst
        docs/codebase/getting-started.rst
    
    
  2. 
      
david
  1. Ship It!
  2. 
      
mike_conley
  1. 
      
  2. docs/codebase/contributing-patches.rst (Diff revision 1)
     
     
     
    Show all issues

    Maybe we should mention what the appropriate branch is - like, make it clear that we have a branch that tracks the current release that's named release-[major]-[minor]-x.

  3. docs/codebase/getting-started.rst (Diff revision 1)
     
     
    Show all issues

    Would it be worth mentioning clear-pycs here?

    1. Probably not here. Might be better as another change, since we likely want a new section for this.

  4. docs/codebase/getting-started.rst (Diff revision 1)
     
     
    Show all issues

    Is there a place where we could stash the currently maintained major and minor release numbers so that we have a central place of truth for these numbers instead of having to update these periodically?

    1. I think it'd require writing a new extension to Sphinx. Not a bad idea, but too big for this change :)

  5. 
      
chipx86
reviewbot
  1. Tool: PEP8 Style Checker
    Ignored Files:
        docs/codebase/custom-forks.rst
        docs/codebase/index.rst
        docs/codebase/contributing-patches.rst
        docs/codebase/unit-tests/fixtures.rst
        docs/codebase/getting-started.rst
    
    
    
    Tool: Pyflakes
    Ignored Files:
        docs/codebase/custom-forks.rst
        docs/codebase/index.rst
        docs/codebase/contributing-patches.rst
        docs/codebase/unit-tests/fixtures.rst
        docs/codebase/getting-started.rst
    
    
  2. 
      
mike_conley
  1. Ship It!
  2. 
      
chipx86
Review request changed

Status: Closed (submitted)

Change Summary:

Pushed to master (f0738b8)
david
  1. Ship It!
  2. 
      
Loading...