Revise final sections of the README

This makes a few additional changes to curb the length of this file,
by moving length documentation (the picture is large) into a separate
file, where other documentation could go. It also corrects the section
on requirements, and attempts to make it more concise.
This commit is contained in:
Ben Thorner
2021-02-22 17:15:09 +00:00
parent 864f4bef66
commit 423b4c7812
2 changed files with 14 additions and 20 deletions

View File

@@ -64,33 +64,20 @@ make bootstrap
make test
```
## Updating application dependencies
## Common tasks
`requirements.txt` file is generated from the `requirements-app.txt` in order to pin
versions of all nested dependencies. If `requirements-app.txt` has been changed (or
we want to update the unpinned nested dependencies) `requirements.txt` should be
regenerated with
### Updating application dependencies
```
make freeze-requirements
```
`requirements.txt` is generated from the `requirements.in` in order to pin versions of all nested dependencies. If `requirements.in` has been changed, run `make freeze-requirements` to regenerate it.
`requirements.txt` should be committed alongside `requirements-app.txt` changes.
### Automatically rebuild the frontend assets
## Automatically rebuild the frontend assets
If you want the front end assets to re-compile on changes, leave this running
in a separate terminal from the app
If you want the front end assets to re-compile on changes, leave this running in a separate terminal from the app
```shell
npm run watch
```
## Working with static assets
## Further docs
When running locally static assets are served by Flask at http://localhost:6012/static/…
When running on preview, staging and production theres a bit more to it:
![notify-static-after](https://user-images.githubusercontent.com/355079/50343595-6ea5de80-051f-11e9-85cf-2c20eb3cdefa.png)
- [Working with static assets](docs/static-assets.md)

7
docs/static-assets.md Normal file
View File

@@ -0,0 +1,7 @@
# Working with static assets
When running locally static assets are served by Flask at http://localhost:6012/static/…
When running on preview, staging and production theres a bit more to it:
![notify-static-after](https://user-images.githubusercontent.com/355079/50343595-6ea5de80-051f-11e9-85cf-2c20eb3cdefa.png)