From 62b05e7700f8cdd466f3f38ab656757812162b01 Mon Sep 17 00:00:00 2001 From: Richard Watts Date: Thu, 20 Jun 2024 09:23:58 +0100 Subject: [PATCH] (fix) Yet more linting SNAFUs --- .trunk/trunk.yaml | 2 ++ README.md | 19 +++++++++++++------ 2 files changed, 15 insertions(+), 6 deletions(-) diff --git a/.trunk/trunk.yaml b/.trunk/trunk.yaml index c107f7b..4289385 100644 --- a/.trunk/trunk.yaml +++ b/.trunk/trunk.yaml @@ -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. diff --git a/README.md b/README.md index b233845..016e8d1 100644 --- a/README.md +++ b/README.md @@ -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 @@ -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 @@ -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 :`) to `mkdocs serve`. +You can set `SERVEROPTS` to pass option (usually `-a +:`) 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.