Skip to content

Commit

Permalink
docs(CHANGELOG): Add to the documentation #43 (#46)
Browse files Browse the repository at this point in the history
* docs(CHANGELOG): Add to the documentation #43

* Created docs/source/CHANGELOG-docs.md
* Added CHANGELOG-docs to the documents index in a TOCtree.
* Added an automatic CHANGELOG-docs update workflow on a Cron schedule.
* Added some dependencies in requirements_dev.txt to preview reST changes.

closes #43

* docs(CHANGELOG): Revert requirements_dev.txt #43

sphinx-copy-button and sphinx-inline-tabs where breaking tests due to
minimum python versions of 3.9.

WIP #43
  • Loading branch information
imAsparky committed Sep 3, 2021
1 parent a957003 commit 4a4c643
Show file tree
Hide file tree
Showing 4 changed files with 105 additions and 0 deletions.
25 changes: 25 additions & 0 deletions .github/workflows/update-changelog-doc.yaml
@@ -0,0 +1,25 @@
name: Auto-generate CHANGELOG-docs
on:
# release:
# types: [created, edited]
schedule:
- cron: "0 15 * * *"
# push:
# branches:
# - main
workflow_dispatch:

jobs:
generate-changelog:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
with:
fetch-depth: 0
- uses: BobAnkh/auto-generate-changelog@master
with:
REPO_NAME: "imAsparky/cookiecutter-py3-package"
ACCESS_TOKEN: ${{secrets.CHANGELOG_UPDATE}}
PATH: "docs/source/CHANGELOG-docs.md"
COMMIT_MESSAGE: "docs(CHANGELOG): update release notes:docs"
TYPE: "chore:Chore,feat:Feature,fix:Bug Fixes,docs:Documentation,perf:Performance Improvements,refactor:Refactor,style:Styling,test:Tests, WIP:In Progress"
65 changes: 65 additions & 0 deletions docs/source/CHANGELOG-docs.md
@@ -0,0 +1,65 @@
# CHANGELOG

## Unreleased

Changes unreleased.

### Chore

- setup:
- Update to setuptools #27 ([c0d3b0d](https://github.com/imAsparky/cookiecutter-py3-package/commit/c0d3b0dc18a58a947a2d9eea5123a31ae39e843c)) ([#33](https://github.com/imAsparky/cookiecutter-py3-package/pull/33))

- Travis:
- Remove support for Travis #18 ([ade1959](https://github.com/imAsparky/cookiecutter-py3-package/commit/ade1959381459abb179df2b3a7c1e25ae695f3db)) ([#23](https://github.com/imAsparky/cookiecutter-py3-package/pull/23))
- Remove support #18 ([aa463f4](https://github.com/imAsparky/cookiecutter-py3-package/commit/aa463f412f26a03a9c1cc278b9bca56e54f114a2)) ([#21](https://github.com/imAsparky/cookiecutter-py3-package/pull/21))

- README:
- Remove stale Similar Templates #11 ([2b62df5](https://github.com/imAsparky/cookiecutter-py3-package/commit/2b62df5f7cf28f6b10fcc17ecebc6dec6dd550e2))

- docs:
- Comment on:push out for CHANGELOG ([ce7b075](https://github.com/imAsparky/cookiecutter-py3-package/commit/ce7b075187b060ca036e34a65f7f8e52a4ab1f0d))

- test:
- Rename workflow #10 ([d4a709b](https://github.com/imAsparky/cookiecutter-py3-package/commit/d4a709bcc6f8a431363b1837c3e78a6718f0ec44))
- Fix typo in jobs:name: #10 ([38f6a89](https://github.com/imAsparky/cookiecutter-py3-package/commit/38f6a89d02b3512f143b6e74b775b8cdbaa2882a))
- Add test coverage Py39 Py3-10 #7 ([a7a9219](https://github.com/imAsparky/cookiecutter-py3-package/commit/a7a921961c2d439ac0724fc539249520f73c6c72))

### Feature

- pre-commit:
- Add to pre-commit to GH #31 ([bf25e6c](https://github.com/imAsparky/cookiecutter-py3-package/commit/bf25e6cf327670a6e7a38e1464de74a25e447205)) ([#32](https://github.com/imAsparky/cookiecutter-py3-package/pull/32))

- test:
- Add GH action to test all contribs #10 ([9f0787d](https://github.com/imAsparky/cookiecutter-py3-package/commit/9f0787d7403429186948a38e4b33a1ea8c66ab71))

- docs:
- Add automatic changelog #8 ([d14487a](https://github.com/imAsparky/cookiecutter-py3-package/commit/d14487aa3f3c190a1720884e1c875bdca055cb7d))
- Add automatic changelog #8 ([0160b52](https://github.com/imAsparky/cookiecutter-py3-package/commit/0160b52a0a623cc48c8400a5700b1a7460cb6812))

- quality:
- Add code quality scan and badge #5 ([fb8fe81](https://github.com/imAsparky/cookiecutter-py3-package/commit/fb8fe81f4d9439e78a33b00babfa2ab3a7ae380b))

- git:
- Add pre-commit and sane tests #3 ([83a8804](https://github.com/imAsparky/cookiecutter-py3-package/commit/83a88044bfb0ce44e54eb05943f2eb2c4282d195))
- Add conventional commits template #2 ([d808d8e](https://github.com/imAsparky/cookiecutter-py3-package/commit/d808d8ef08ca158f98bf5a302062f13ab503ab31))
- Add additional issue templates #1 ([6f5c9da](https://github.com/imAsparky/cookiecutter-py3-package/commit/6f5c9da926b158d2116db2cee3f1bf3ac459c86b))

### Bug Fixes

- git:
- Remove test for py3.10 #26 ([e5fdef2](https://github.com/imAsparky/cookiecutter-py3-package/commit/e5fdef216b7adf4c0759d85fc2b90a733d2f4426))

### Documentation

- structure:
- Update to newer sphinx style #34 ([6f76c4e](https://github.com/imAsparky/cookiecutter-py3-package/commit/6f76c4ead0bb70be7f9630a0fb12ab8f6297bf7d)) ([#35](https://github.com/imAsparky/cookiecutter-py3-package/pull/35))

- README:
- Add to list of notable changes (#24) ([5db0139](https://github.com/imAsparky/cookiecutter-py3-package/commit/5db0139e3c21190b3d2085d3c4947beeac2fea25)) ([#24](https://github.com/imAsparky/cookiecutter-py3-package/pull/24))
- Remove support for Travis CI #18 ([0dd88fa](https://github.com/imAsparky/cookiecutter-py3-package/commit/0dd88fa56d5646caddd54828a2640fa96379d0af))
- Update to reflect this fork #4 ([e592c57](https://github.com/imAsparky/cookiecutter-py3-package/commit/e592c5750e36aff5b8486e0324e8778510498d7c))

- fork:
- Update to indicate this fork #20 ([f287b06](https://github.com/imAsparky/cookiecutter-py3-package/commit/f287b06c8bf40262728bfe2dfe5d542200d0b2ba))

\* *This CHANGELOG was automatically generated by [auto-generate-changelog](https://github.com/BobAnkh/auto-generate-changelog)*
12 changes: 12 additions & 0 deletions docs/source/index.rst
Expand Up @@ -29,6 +29,18 @@ Advanced Features
console_script_setup


Changelog
---------

.. toctree::
:maxdepth: 2
:caption: Contents:

CHANGELOG-docs.md




Todo List to improve cookiecutter-py3-package docs.
---------------------------------------------------

Expand Down
3 changes: 3 additions & 0 deletions requirements_dev.txt
@@ -1,5 +1,8 @@
alabaster==0.7.12
cookiecutter>=1.4.0
furo==2021.8.11b42
myst-parser==0.15.2
Sphinx==4.1.2
pre-commit==2.14.1
pytest==5.3.1
pytest-cookies==0.5.1
Expand Down

0 comments on commit 4a4c643

Please sign in to comment.