Skip to content

Commit

Permalink
Merge pull request #323 from openreferral/revert-322-316-readme-rtd
Browse files Browse the repository at this point in the history
Revert "316 readme rtd"
  • Loading branch information
lgs85 authored Jan 20, 2023
2 parents f282047 + 5caa70d commit 342b69e
Show file tree
Hide file tree
Showing 68 changed files with 1,721 additions and 285,737 deletions.
19 changes: 0 additions & 19 deletions .github/pull_request_template.md

This file was deleted.

39 changes: 0 additions & 39 deletions .readthedocs.yaml

This file was deleted.

39 changes: 9 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,42 +20,13 @@ We encourage you to use an [open license](http://licenses.opendefinition.org/) f

Earlier versions were licensed under CC0.

## Setup environment for docs and schema tools

Set up an environment and install Python dependencies into it:

```
python3 -m venv .ve
source .ve/bin/activate
pip install -r requirements.txt
```

This will install everything needed to run the docs and the `hsds_schema.py` executable.

If you run into any errors with the docs or schema building, make sure an existing environment is up-to-date by running:

```
pip install --upgrade -r requirements.txt
```

## Building datapackage.json, examples and compiled schemas

After changing any schemas the following command needs to be run:

```
hsds_schema.py docs-all
```

This will update the `datapackage.json` file, the examples and the compiled schemas.


## Building the documentation

### ReadTheDocs

Any change pushed to the master branch on GitHub will be built and pushed to http://docs.openreferral.org/en/latest/ automatically by ReadTheDocs. Build info is found at https://readthedocs.org/projects/openreferral/builds/

Other branches are also built automatically and can be viewed by typing the branch name into the ReadTheDocs url. Branches other than the master branch are hidden from the ReadTheDocs flyout menu. ReadTheDocs settings can be configured by admins of the 'openreferral' project on ReadTheDocs, on this page - https://readthedocs.org/projects/openreferral/versions/
Other branches are not built automatically, but can be configured by admins of the 'openreferral' project on ReadTheDocs, on this page - https://readthedocs.org/projects/openreferral/versions/

### Building locally

Expand All @@ -67,6 +38,14 @@ You will need graphviz installed. For Ubuntu:
apt-get install graphviz libgraphviz-dev
```

Set up an environment and install Python dependencies into it:

```
python3 -m venv .ve
source .ve/bin/activate
pip install -r requirements.txt
```

Then pull in the submodule for the API documentation.

```
Expand Down
Loading

0 comments on commit 342b69e

Please sign in to comment.