Flesh out the front page of the Administration Guide.

Review Request #8485 — Created Oct. 24, 2016 and submitted

Information

Review Board
release-2.5.x
a59fc32...

Reviewers

This change follows up on the Users Guide improvements, fleshing out the
content of the front page of the Administration Guide. This walks admins
through the installation and upgrade steps, and groups the various
settings and configuration steps needed to get started.

Future changes may flesh some of this out more, but for now, it's a much
better experience for new admins, and even old ones trying to locate
something they need to look up.

The plan later on is to add a new section on guides for common setups
(like setting up GitHub, Bitbucket, etc.).

Built the docs and read through them.


Description From Last Updated

Typo: "MysQL"

daviddavid

I think repositories should come before review groups.

daviddavid
reviewbot
  1. Tool: PEP8 Style Checker
    Ignored Files:
        docs/manual/admin/index.rst
        docs/manual/admin/installation/linux.rst
    
    
    
    Tool: Pyflakes
    Ignored Files:
        docs/manual/admin/index.rst
        docs/manual/admin/installation/linux.rst
    
    
  2. 
      
david
  1. 
      
  2. docs/manual/admin/index.rst (Diff revision 1)
     
     
    Show all issues

    Typo: "MysQL"

  3. docs/manual/admin/index.rst (Diff revision 1)
     
     
    Show all issues

    I think repositories should come before review groups.

    1. I put it there just because review groups are a configuration option in repositories, for access control. I'm open to changing that, though.

    2. I think that for most people, connecting the repository is the first major step towards getting things set up, and will likely happen before they add any other users, much less groups. We talk about access control for everything just under this.

  4. 
      
chipx86
reviewbot
  1. Tool: Pyflakes
    Ignored Files:
        docs/manual/admin/index.rst
        docs/manual/admin/installation/linux.rst
    
    
    
    Tool: PEP8 Style Checker
    Ignored Files:
        docs/manual/admin/index.rst
        docs/manual/admin/installation/linux.rst
    
    
  2. 
      
david
  1. Ship It!
  2. 
      
chipx86
Review request changed
Status:
Completed
Change Summary:
Pushed to release-2.5.x (77303b1)