Skip to content
This repository has been archived by the owner on Sep 30, 2021. It is now read-only.

Commit

Permalink
DevKit updates (#463)
Browse files Browse the repository at this point in the history
  • Loading branch information
SonataCI authored Nov 6, 2017
1 parent d45f0d2 commit 35a5b84
Show file tree
Hide file tree
Showing 3 changed files with 5 additions and 5 deletions.
2 changes: 1 addition & 1 deletion .travis/install_docs.sh
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
#!/usr/bin/env sh
set -ev

pip install -r docs/requirements.txt --user
pip install -r Resources/doc/requirements.txt --user
6 changes: 3 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,13 +74,13 @@ php-cs-fixer fix --verbose

#### The documentation

The documentation is mostly written with the `rst` format, and can be found in the `docs` directory.
The documentation is mostly written with the `rst` format, and can be found in the `Resources/doc` directory.
You can test the doc rendering with the `make docs` command, but to do this, you will need [Sphinx][sphinx_install].
Just like php dependencies can be managed with Composer, python dependencies can be managed with [pip][pip_install].
To get sphinx, simply run the following command.

```bash
pip install --requirement docs/requirements.txt --user
pip install --requirement Resources/doc/requirements.txt --user
```

Some python binaries should be downloaded to `~/.local/bin` for Linux or `~/Library/Python/2.7/bin` for Mac OS,
Expand All @@ -90,7 +90,7 @@ so that it contains this path and then, from the root of the project, run `make
If `make docs` is successful, you should be able to see your modifications:

```bash
$YOUR_FAVORITE_BROWSER docs/_build/html/index.html
$YOUR_FAVORITE_BROWSER Resources/doc/_build/html/index.html
```

If your PR contains a new feature, you must add documentation for it.
Expand Down
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -19,4 +19,4 @@ test:
phpunit -c phpunit.xml.dist --coverage-clover build/logs/clover.xml

docs:
cd docs && sphinx-build -W -b html -d _build/doctrees . _build/html
cd Resources/doc && sphinx-build -W -b html -d _build/doctrees . _build/html

0 comments on commit 35a5b84

Please sign in to comment.