Skip to content

Commit f30d7d5

Browse files
authored
Merge pull request #42 from executablebooks/rls
🚀 RELEASE: v0.0.3
2 parents 8af50ac + 413fefa commit f30d7d5

File tree

3 files changed

+86
-3
lines changed

3 files changed

+86
-3
lines changed

CHANGELOG.md

Lines changed: 83 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,83 @@
1+
# Changelog
2+
3+
## [v0.0.3](https://github.com/executablebooks/sphinx-proof/tree/v0.0.3) (2020-10-09)
4+
5+
[Full Changelog](https://github.com/executablebooks/sphinx-proof/compare/v0.0.2...v0.0.3)
6+
7+
### New ✨
8+
9+
We moved away from `sphinxcontrib-prettyproof` and renamed the extension `sphinx-proof`.
10+
11+
### Improved 👌
12+
13+
Among other improvements:
14+
15+
- The proof domain has been renamed "prf" to follow similar naming conventions to other Sphinx domains.
16+
- Introduced the following new directives
17+
+ example
18+
+ property
19+
+ observation
20+
+ proposition
21+
- Reviewed our test infrastructure to make sure we are following Executable Book Project's contributing guidelines #19 (@AakashGfude).
22+
- Implemented GitHub Actions to build, test, and deploy our code.
23+
- Enhanced the design of the directives per our users' request.
24+
25+
26+
### DEPRECATE 🗑️
27+
28+
`sphinx-exercise` no longer support `exercise` directives. This work has moved to a new extension names `sphinx-exercise`.
29+
30+
### Fixes 🐛
31+
32+
- Fixed math label error in proof directive.
33+
- ReadTheDocs builds documentation use a dev mode environment through the rtd extra.
34+
35+
### Documentation improvements 📚
36+
37+
In addition to other minor documentation improvements, we also introduced high-level description of the API.
38+
39+
**Closed issues:**
40+
41+
- Documentation similarities to / different decisions from sphinxcontrib-proof [\#37](https://github.com/executablebooks/sphinx-proof/issues/37)
42+
- Add a high-level description of the API first on /syntax.html [\#35](https://github.com/executablebooks/sphinx-proof/issues/35)
43+
- \[ENH\] Use upstream flake8 instead of the one provided as pre-commit hook [\#28](https://github.com/executablebooks/sphinx-proof/issues/28)
44+
- Plain background for examples? [\#22](https://github.com/executablebooks/sphinx-proof/issues/22)
45+
- Drop italics in proof body? [\#21](https://github.com/executablebooks/sphinx-proof/issues/21)
46+
- Styling for "proof" too loud? [\#14](https://github.com/executablebooks/sphinx-proof/issues/14)
47+
- \[DISC\] `{proof:proof}` directive has `class` option? [\#9](https://github.com/executablebooks/sphinx-proof/issues/9)
48+
- \[ENH\] Discussion of Syntax Choices [\#6](https://github.com/executablebooks/sphinx-proof/issues/6)
49+
- \[DOC\] Adding documentation for conjectures [\#4](https://github.com/executablebooks/sphinx-proof/issues/4)
50+
- \[BUG\] Math Block `$$ $$` inside proof directive throws error [\#2](https://github.com/executablebooks/sphinx-proof/issues/2)
51+
52+
**Merged pull requests:**
53+
54+
- 👌 IMPROVE: Rename "proof" domain and role to "prf" [\#46](https://github.com/executablebooks/sphinx-proof/pull/46) ([najuzilu](https://github.com/najuzilu))
55+
- ✨ NEW: Migrate to sphinx-proof [\#44](https://github.com/executablebooks/sphinx-proof/pull/44) ([najuzilu](https://github.com/najuzilu))
56+
- 🐛 FIX: RTD fail to install local extension [\#43](https://github.com/executablebooks/sphinx-proof/pull/43) ([najuzilu](https://github.com/najuzilu))
57+
- 🔧 MAINTAIN: Misc edits [\#40](https://github.com/executablebooks/sphinx-proof/pull/40) ([najuzilu](https://github.com/najuzilu))
58+
- 📚 DOCS: Add high-level description of API under syntax [\#39](https://github.com/executablebooks/sphinx-proof/pull/39) ([najuzilu](https://github.com/najuzilu))
59+
- 🗑️ DEPRECATE: Remove exercise directive [\#38](https://github.com/executablebooks/sphinx-proof/pull/38) ([najuzilu](https://github.com/najuzilu))
60+
- 🔧 MAINTAIN: Update links to reflect migration to EBP [\#36](https://github.com/executablebooks/sphinx-proof/pull/36) ([najuzilu](https://github.com/najuzilu))
61+
- 📚 DOCS: Add class option for `proof:proof` [\#34](https://github.com/executablebooks/sphinx-proof/pull/34) ([najuzilu](https://github.com/najuzilu))
62+
- 📚 DOCS: Additional documentation [\#33](https://github.com/executablebooks/sphinx-proof/pull/33) ([najuzilu](https://github.com/najuzilu))
63+
- ✨️ NEW: Add MANIFEST file [\#31](https://github.com/executablebooks/sphinx-proof/pull/31) ([AakashGfude](https://github.com/AakashGfude))
64+
- 👌️ IMPROVE: Update extras [\#30](https://github.com/executablebooks/sphinx-proof/pull/30) ([najuzilu](https://github.com/najuzilu))
65+
- 👌️ IMPROVE: Using upstream flake8 [\#29](https://github.com/executablebooks/sphinx-proof/pull/29) ([AakashGfude](https://github.com/AakashGfude))
66+
- 👌️ IMPROVE: Add tox.ini [\#26](https://github.com/executablebooks/sphinx-proof/pull/26) ([najuzilu](https://github.com/najuzilu))
67+
- \[ENH\] Implement Github workflow [\#25](https://github.com/executablebooks/sphinx-proof/pull/25) ([najuzilu](https://github.com/najuzilu))
68+
- \[STY\] Remove `example` directive background color [\#24](https://github.com/executablebooks/sphinx-proof/pull/24) ([najuzilu](https://github.com/najuzilu))
69+
- \[STY\] Fixes \#21: remove italics from proof [\#23](https://github.com/executablebooks/sphinx-proof/pull/23) ([najuzilu](https://github.com/najuzilu))
70+
- Miscellaneous edits [\#20](https://github.com/executablebooks/sphinx-proof/pull/20) ([najuzilu](https://github.com/najuzilu))
71+
- 👌️ IMPROVE: Review of test infrastructure [\#19](https://github.com/executablebooks/sphinx-proof/pull/19) ([AakashGfude](https://github.com/AakashGfude))
72+
- \[STY\] Update style of proof directive [\#15](https://github.com/executablebooks/sphinx-proof/pull/15) ([najuzilu](https://github.com/najuzilu))
73+
- \[ENH, DOC\] Add `example`, `property`, `observation` and `proposition` directives [\#12](https://github.com/executablebooks/sphinx-proof/pull/12) ([najuzilu](https://github.com/najuzilu))
74+
- \[FIX,TST\] Fix math label in proof directive [\#11](https://github.com/executablebooks/sphinx-proof/pull/11) ([najuzilu](https://github.com/najuzilu))
75+
- \[DOCS\] add suggested changes for docs [\#5](https://github.com/executablebooks/sphinx-proof/pull/5) ([mmcky](https://github.com/mmcky))
76+
77+
## [v0.0.2](https://github.com/executablebooks/sphinx-proof/tree/v0.0.2) (2020-08-25)
78+
79+
[Full Changelog](https://github.com/executablebooks/sphinx-proof/compare/7977433b6888f1bdbfcda0b41c8cc226d539758e...v0.0.2)
80+
81+
82+
83+
\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)*

docs/source/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ corollary, algorithm, example, property, observation and proposition directives.
2121

2222

2323
```{warning}
24-
sphinx-proof `0.0.2` is in a development stage and may change rapidly.
24+
sphinx-proof `0.0.3` is in a development stage and may change rapidly.
2525
```
2626

2727
**Features**:
@@ -39,7 +39,7 @@ To get started with `sphinx-proof`, first install it through `pip`:
3939
pip install sphinx-proof
4040
```
4141

42-
### JuputerBook Project
42+
### Juputer-Book Project
4343

4444
Add `sphinx_proof` to your [extra_extensions](https://jupyterbook.org/advanced/sphinx.html#custom-sphinx-extensions) config in `_config.yml`
4545

setup.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
from setuptools import setup, find_packages
44

5-
VERSION = "v0.0.2a"
5+
VERSION = "v0.0.3"
66

77
LONG_DESCRIPTION = """
88
This package contains a [Sphinx](http://www.sphinx-doc.org/en/master/) extension

0 commit comments

Comments
 (0)