Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

WIP: Improve documentation #531

Closed
wants to merge 38 commits into from
Closed

WIP: Improve documentation #531

wants to merge 38 commits into from

Conversation

JonathanHuot
Copy link
Member

Wanted to improve documentation to both be sure we have no errors, nor misleading examples, and also be clear for new users.

Started with another round of review lead me to fix minors stuff (copyright, typo, ..), but also I have added a credits to previous team.

Also, setup.py/long_description aka README.rst is now tested locally before pushed to pypi (and github).

The already identified areas of improvements are: #209 #213 #234 #242 #287 #320 #373 thanks to @ib-lundgren for this list.

lepture and others added 30 commits October 20, 2017 00:13
The wheel package format supports including the license file. This is
done using the [metadata] section in the setup.cfg file. For additional
information on this feature, see:

https://wheel.readthedocs.io/en/stable/index.html#including-the-license-in-the-generated-wheel-file

(cherry picked from commit 1421524)
For Travis CI documentation on including a bdist_wheel distribution,
see:

https://docs.travis-ci.com/user/deployment/pypi/#Uploading-different-distributions

Fixes #493

(cherry picked from commit 4b85d90)
* Check access token in self.token dict

* fix typo

(cherry picked from commit fa0b63c)
(cherry picked from commit 66d7296)
* Added sphinx build for developers

Rationale is to build docs locally to prevent RTD to break later.

* Replace manual sphinx into make

* Renamed idan URL to oauthlib community

* Renamed http into https URLs since http is returning 302

* python requests library renamed its home URL

* Add ignore list for "make linkcheck"

linkcheck is doing requests to github with anonymous access, however creating an issue require an logged-in account

* virtualenv changed its homepage and website.

* Fixed broken link

(cherry picked from commit 32e5ad1)
(cherry picked from commit d93403a)
(cherry picked from commit f398fdb)
(cherry picked from commit 6490295)
* Fix indentation in Travis config.
* Fill GitHub OAuth key.
* Deploy tags from all branches.

(cherry picked from commit e2f40a9)
@JonathanHuot
Copy link
Member Author

Hi, we could merge the existing commits and let the #209 #213 #234 #242 #287 #320 #373 in the backlog. Others?

@JonathanHuot JonathanHuot changed the base branch from 2.x to master August 10, 2018 10:58
* Added sphinx build for developers

Rationale is to build docs locally to prevent RTD to break later.

* Replace manual sphinx into make

* Renamed idan URL to oauthlib community

* Renamed http into https URLs since http is returning 302

* python requests library renamed its home URL

* Add ignore list for "make linkcheck"

linkcheck is doing requests to github with anonymous access, however creating an issue require an logged-in account

* virtualenv changed its homepage and website.

* Fixed broken link

(cherry picked from commit 32e5ad1)
@JonathanHuot
Copy link
Member Author

This branch diverged too much, recreating one.

@JonathanHuot JonathanHuot mentioned this pull request Aug 10, 2018
@JonathanHuot JonathanHuot deleted the improve-doc branch January 28, 2019 11:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants