Skip to content

Commit

Permalink
(fix) Yet more linting SNAFUs
Browse files Browse the repository at this point in the history
  • Loading branch information
rrw-zilliqa committed Jun 20, 2024
1 parent 56cb9c2 commit 62b05e7
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 6 deletions.
2 changes: 2 additions & 0 deletions .trunk/trunk.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,8 @@ lint:
paths:
- zq2/docs/ecosystem/index.md # multiple headers
- zq2/docs/zilevm/tools/remix.md # Don't care about line length
- README.md
- DEPLOY.md
- linters: [ALL]
paths:
- Dockerfile # Annoying, but trunk is now very opinionated on how you write dockerfiles.
Expand Down
19 changes: 13 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,18 @@ This repository contains the Zilliqa developer documentation.

## How it works

The developer portal is a pair of `mkdocs` materials-themed sites - one for Zilliqa 1 and one for Zilliqa 2.
The developer portal is a pair of `mkdocs` materials-themed sites -
one for Zilliqa 1 and one for Zilliqa 2.

The Zilliqa 1 site is static.
The Zilliqa 2 site includes content created by the rust program in `docgen` - see below.

They are served in production by an nginx container containing the routing between the two, built by the `Dockerfile` and using the config file from `default.conf`.
They are served in production by an nginx container containing the
routing between the two, built by the `Dockerfile` and using the
config file from `default.conf`.

The material theme is fairly heavily customised with overrides in both Zilliqa 1 and Zilliqa 2.
The material theme is fairly heavily customised with overrides in both
Zilliqa 1 and Zilliqa 2.

## Docgen

Expand All @@ -35,7 +39,8 @@ The `docgen` program:

Development is controlled by the `Makefile` in this directory.

You will need `mkdocs`. Make sure you're in a venv (because `mkdocs` doesn't seem to like installing outside one):
You will need `mkdocs`. Make sure you're in a venv (because `mkdocs`
doesn't seem to like installing outside one):

```sh
python -m venv ~/mydir
Expand All @@ -59,6 +64,8 @@ Now,
- `make dev1` will make and serve the ZQ1 docs locally on port 8000.
- `make dev2` will do the same with the ZQ2 docs.

You can set `SERVEROPTS` to pass option (usually `-a <listen_address>:<port>`) to `mkdocs serve`.
You can set `SERVEROPTS` to pass option (usually `-a
<listen_address>:<port>`) to `mkdocs serve`.

If you want to check containerised builds, `make run-image` will do that for you and run it on port 8080.
If you want to check containerised builds, `make run-image` will do
that for you and run it on port 8080.

0 comments on commit 62b05e7

Please sign in to comment.