Note: anyone on the GitHub Pillow Team interested in receiving donations for their contributions may do so via the Gratipay Pillow Team (https://gratipay.com/pillow/). I'm not sure how to add folks, but if you are interested I will figure it out (I'm currently the only recipient.)
A while back somebody awesome forked the PIL Handbook (http://effbot.org/imagingbook/pil-index.htm) to Pillow. IIRC we tried to incorporate the handbook "seemlessly", which apparently meant not using the word "handbook" anywhere. Now that seems confusing, so I'm reorganizing all the handbook content under one section named "Handbook".
This commit:
- Moves guides.rst to handbook/index.rst
- Moves appendices.rst to handbook/
- Removes developer.rst from handbook index.
- Removes porting-pil-to-pillow.rst from handbook index.
Unrelated to the above:
- Shorten title "Porting existing PIL-based code to Pillow" to "Porting"
- Move text "Porting existing PIL-based code to Pillow" to faux sub-header (bold text not sub-header because there's only one section.)
"Porting" may be better named "Migrating", not sure yet.
- Add Makefile target ``make readme`` to run ``viewdoc``
- Reorg "More Info" sections
- Docs to the top
- Less doc links (folks can find more than installation & guides from documentation link)
- Add link to PRs
- Reorg link to pre-fork changes
Three "build: passing" badges in a row looks a bit odd.
AppVeyor allows you to customise the right-hand side text (http://www.appveyor.com/docs/status-badges), but Travis CI doesn't.
But Shields.io allows you to override the default left-hand-side text (which makes more sense) and supports both Travis CI and AppVeyor.
TODO: update Windows branch to master when available.
I've not liked the "plain" readme for the last few releases, so I've adjusted things hopefully for the better:
- Rename/add section headers
- Divide content into two sections
- Provide bulleted list with most important links e.g. "install"
Pillow isn't at 100% code health, there's plenty of PEP8 and Pyflakes warnings in our Travis CI. This is a bug in Landscape:
https://github.com/landscapeio/landscape-issues/issues/70
Let's remove the badge until Landscape's working properly.
Re: #895.
