Updated documentation.

Author: john-hen

PyPI.md

@@ -11,14 +11,10 @@ and pull requests were marked as "spam" ([#1332], [#1421], [#1431],
 *Flake8-pyproject* also has bad manners and force-feeds Flake8 the
 spam it so despises.
 
-It is inspired by [pyproject-Flake8], which had received little
-maintenance following its initial commit. Though this may have changed
-in the meantime. Consider using it instead, or any of the other
-alternatives mentioned in [issue #2].
-
-Compared to `pyproject-Flake8`, the code here (little as there was to
-begin with) was completely rewritten and a simple test suite makes it
-all a little more palatable.
+It is inspired by [pyproject-Flake8], though the code was rewritten
+from scratch and a test suite was added to make maintenance easier.
+You may however consider using the original project instead, or any
+of the other alternatives mentioned in [issue #2].
 
 [Flake8]:           https://github.com/PyCQA/flake8
 [#234]:             https://github.com/PyCQA/flake8/issues/234
@@ -36,9 +32,6 @@ all a little more palatable.
 First, move your Flake8 configuration to `pyproject.toml`. Then,
 optionally, add Flake8p as a git pre-commit hook.
 
-
-### Move the configuration
-
 Say your Flake8 configuration in `.flake8` (or in `tox.ini`, or
 `setup.cfg`) is this:
 ```ini
@@ -65,13 +58,8 @@ count = true
 From then on run `flake8p` instead of `flake8` to lint the code, so that
 the configuration in `pyproject.toml` will be used.
 
-[TOML format]: https://toml.io
-
-
-### Add pre-commit hook
-
-Automatically apply `flake8p` upon `git commit` by adding the following
-to your project's pre-commit configuration:
+To have `flake8p` run on every `git commit`, add the following to your
+project's pre-commit configuration:
 
 ```yaml
 # your-project-root/.pre-commit-hooks.yaml
@@ -81,6 +69,8 @@ to your project's pre-commit configuration:
     -   id: Flake8-pyproject
 ```
 
+[TOML format]: https://toml.io
+
 
 ## Implementation
 

ReadMe.md

@@ -11,14 +11,10 @@ and pull requests were marked as "spam" ([#1332], [#1421], [#1431],
 *Flake8-pyproject* also has bad manners and force-feeds Flake8 the
 spam it so despises.
 
-It is inspired by [pyproject-Flake8], which had received little
-maintenance following its initial commit. Though this may have changed
-in the meantime. Consider using it instead, or any of the other
-alternatives mentioned in [issue #2].
-
-Compared to `pyproject-Flake8`, the code here (little as there was to
-begin with) was completely rewritten and a simple test suite makes it
-all a little more palatable.
+It is inspired by [pyproject-Flake8], though the code was rewritten
+from scratch and a test suite was added to make maintenance easier.
+You may however consider using the original project instead, or any
+of the other alternatives mentioned in [issue #2].
 
 [Flake8]:           https://github.com/PyCQA/flake8
 [#234]:             https://github.com/PyCQA/flake8/issues/234
@@ -36,9 +32,6 @@ all a little more palatable.
 First, move your Flake8 configuration to `pyproject.toml`. Then,
 optionally, add Flake8p as a git pre-commit hook.
 
-
-### Move the configuration
-
 Say your Flake8 configuration in `.flake8` (or in `tox.ini`, or
 `setup.cfg`) is this:
 ```ini
@@ -65,13 +58,8 @@ count = true
 From then on run `flake8p` instead of `flake8` to lint the code, so that
 the configuration in `pyproject.toml` will be used.
 
-[TOML format]: https://toml.io
-
-
-### Add pre-commit hook
-
-Automatically apply `flake8p` upon `git commit` by adding the following
-to your project's pre-commit configuration:
+To have `flake8p` run on every `git commit`, add the following to your
+project's pre-commit configuration:
 
 ```yaml
 # your-project-root/.pre-commit-hooks.yaml
@@ -81,6 +69,8 @@ to your project's pre-commit configuration:
     -   id: Flake8-pyproject
 ```
 
+[TOML format]: https://toml.io
+
 
 ## Implementation
 

tools/release.md

@@ -1,7 +1,7 @@
 Steps to take when releasing a new version:
 * Bump version number in `meta.py`.
 * Add dedicated commit for the version bump.
-* Tag commit with version number, e.g. `git tag 0.9.0`.
+* Tag commit with version number, e.g. `git tag 1.0.0`.
 * Push to GitHub: `git push && git push --tags`.
 * Create GitHub release from tag and add release notes.
-* Publish to PyPI: `deploy/publish.py`.
+* Publish to PyPI: `tools/publish.py`.