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

Fix documentation #1038

Merged
merged 40 commits into from
Sep 9, 2021
Merged
Changes from 1 commit
Commits
Show all changes
40 commits
Select commit Hold shift + click to select a range
a3b5b6f
Add flake8-rst-docstrings
Aug 30, 2021
04f2513
Add task to test the doc
Aug 28, 2021
9dc68ea
Whitelist the attribute directive
Aug 30, 2021
26b1a25
Whitelist the class role
Aug 30, 2021
f783ffd
Whitelist the meth role
Aug 30, 2021
3255f0a
Whitelist the obj role
Aug 30, 2021
f83f167
Whitelist the exc role
Aug 30, 2021
45dad35
Fix invalid markdown in rst docstring
Aug 30, 2021
cab2091
Fix invalid rst
Aug 30, 2021
178c14e
Fix malformed table
Aug 28, 2021
c2d475e
Fix reference to numpy in enums
Aug 28, 2021
fdbaf6e
Fix missing reference in simulations
Aug 28, 2021
d90b859
Fix missing reference in test runner
Aug 28, 2021
2eadc1d
Fix missing reference in tax benefit systems
Aug 28, 2021
2d71b50
Fix missing reference in parameters
Aug 28, 2021
ad9218c
Fix missing reference in variables
Aug 28, 2021
8037dca
Fix missing reference to error
Aug 28, 2021
93718b8
Fix missing reference in tax benefit systems
Aug 28, 2021
37e1980
Fix missing reference in test runner
Aug 28, 2021
2f59d9c
Fix missing reference in variables
Aug 28, 2021
de38100
Split test task in subtasks
Aug 29, 2021
a2003e0
Add option to pass the branch
Aug 29, 2021
7f671ed
Handle rebased/squashed branches
Aug 29, 2021
246bd19
Move repo to a variable
Aug 29, 2021
fb30b75
Fallback to master if no such branch
Aug 29, 2021
20d0a67
Checkout doc in circleci
Aug 29, 2021
1427760
Move test docs to its own job
Aug 29, 2021
6d19e2d
Install doc in circleci
Aug 29, 2021
23b1a81
Build doc in circleci
Aug 29, 2021
7313deb
Document how to verify that the doc build
Aug 29, 2021
5cee544
Fix wrong markup in contributing
Aug 29, 2021
3b5e95c
Add how to doc to contributing
Aug 29, 2021
7073cac
Add how to fix the doc
Aug 29, 2021
bf88c8d
Fix doc tracers
Sep 1, 2021
7b0d865
Fix doc parameters
Sep 1, 2021
bdda1a9
Fix doc variables
Sep 1, 2021
01f3193
Fix default branch to current
Sep 1, 2021
d991bdc
Change commit message in README.md
Sep 7, 2021
95e94a5
Use hyphens in Makefile
Sep 7, 2021
df51e0b
Bump minor to 35.5.0
Sep 1, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Document how to verify that the doc build
  • Loading branch information
Mauko Quiroga committed Sep 1, 2021
commit 7313deb0f59c8ba693c684d8b176771ae6ec03cc
12 changes: 12 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,18 @@ exec make format-style
END
```

## Documentation

Yet however OpenFisca does not follow a common convention for docstrings, our current toolchain allows to check whether documentation builds correctly and to update it automatically with each contribution to this repository.

In the meantime, please take a look at our [contributing guidelines](CONTRIBUTING.md) for some general tips on how to document your contributions, and at our official documentation's [repository](https://github.com/openfisca/openfisca-doc/blob/master/README.md) to in case you want to know how to build it by yourself —and improve it!

To verify that the documentation still builds correctly, you can run:

```sh
make test.doc
benjello marked this conversation as resolved.
Show resolved Hide resolved
```

## Serving the API

OpenFisca-Core provides a Web-API. It is by default served on the `5000` port.
Expand Down