Skip to content

Commit

Permalink
docs: update contributing notes on benchmarks
Browse files Browse the repository at this point in the history
  • Loading branch information
casperdcl committed Jul 10, 2020
1 parent 56bd2cc commit 6c02eb9
Show file tree
Hide file tree
Showing 3 changed files with 18 additions and 13 deletions.
4 changes: 2 additions & 2 deletions .github/workflows/bench.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,8 @@ jobs:
asv run --skip-existing-commits -j 8 v3.2.0..HEAD
- name: Build pages
run: |
git config user.email "$GIT_AUTHOR_EMAIL"
git config user.name "$GIT_AUTHOR_NAME"
git config --global user.email "$GIT_AUTHOR_EMAIL"
git config --global user.name "$GIT_AUTHOR_NAME"
asv gh-pages --no-push
git push -f origin gh-pages:gh-pages
env:
Expand Down
25 changes: 15 additions & 10 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -321,12 +321,15 @@ following:
Additionally (less maintained), there exists:

- A [wiki] which is publicly editable.
- The [gh-pages project](https://tqdm.github.io/tqdm/) which is built from the
- The [gh-pages project] which is built from the
[gh-pages branch](https://github.com/tqdm/tqdm/tree/gh-pages), which is
built using [asv](https://github.com/spacetelescope/asv/).
- The [gh-pages root](https://tqdm.github.io/) which is built from a separate
built using [asv](https://github.com/airspeed-velocity/asv).
- The [gh-pages root] which is built from a separate
[github.io repo](https://github.com/tqdm/tqdm.github.io).

[gh-pages project]: https://tqdm.github.io/tqdm/
[gh-pages root]: https://tqdm.github.io/


## Helper Bots

Expand All @@ -338,7 +341,9 @@ to assist with maintenance.
+ allows maintainers to write `/tag vM.m.p commit_hash` in an issue/PR to create a tag
- Post Release
+ automatically updates the [wiki]
+ TODO: automatically updates [gh-pages](https://tqdm.github.io/)
+ TODO: automatically updates the [gh-pages root]
- Benchmark
+ automatically updates the [gh-pages project]


## QUICK DEV SUMMARY
Expand Down Expand Up @@ -372,12 +377,12 @@ Much is automated so really it's steps 1-6, then 12(a).
13. **`[SUB][AUTO:GHActions]`** run `make` in the `wiki` submodule to update release notes
14. **`[SUB]`** run `make deploy` in the `docs` submodule to update website
15. **`[SUB][AUTO:GHActions]`** accept the automated PR in the `feedstock` submodule to update conda
16. **`[AUTO:GHActions]`** update the [gh-pages project] benchmarks
a) `[python setup.py] make testasvfull`
b) `asv gh-pages`

Key:

- **`[AUTO:TravisCI]`**: Travis CI should automatically do this after
`git push --tags` (6)
- **`[AUTO:GHActions]`**: GitHub Actions CI should automatically do this after
`git push --tags` (6)
- **`[SUB]`**: Requires one-time `make submodules` to clone
`docs`, `wiki`, and `feedstock`
- **`[AUTO:TravisCI]`**: Travis CI should automatically do this after `git push --tags` (6)
- **`[AUTO:GHActions]`**: GitHub Actions CI should automatically do this
- **`[SUB]`**: Requires one-time `make submodules` to clone `docs`, `wiki`, and `feedstock`
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ testasv:

testasvfull:
# Test all the commits since the beginning (full test)
asv run -j 8 v1.0.0..master
asv run --skip-existing-commits -j 8 v1.0.0..HEAD
@make testasv

viewasv:
Expand Down

0 comments on commit 6c02eb9

Please sign in to comment.