docs: update docsgen scripting and add new docs content

.dockerignore

@@ -46,11 +46,11 @@ packages/beacon-node/mainnet_pubkeys.csv
 # Autogenerated docs
 packages/**/docs
 packages/**/typedocs
-docs/packages
-docs/contributing.md
-docs/assets
-docs/reference/cli.md
-/site
+docs/pages/**/*-cli.md
+docs/pages/assets
+docs/pages/api/api-reference.md
+docs/pages/contribution/getting-started.md
+docs/site
 
 # Lodestar artifacts
 .lodestar

.github/workflows/docs.yml

@@ -45,15 +45,17 @@ jobs:
         uses: actions/setup-python@v1
 
       - name: Install dependencies
+        working-directory: docs
         run: |
           python -m pip install --upgrade pip
-          pip install -r docs/requirements.txt
+          pip install -r requirements.txt
 
       - name: Build docs
-        run: mkdocs build --site-dir site -v --clean
+        working-directory: docs
+        run: mkdocs build --verbose --clean --site-dir site
 
       - name: Deploy
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./site
+          publish_dir: ./docs/site

.gitignore

@@ -40,11 +40,14 @@ packages/api/oapi-schemas
 # Autogenerated docs
 packages/**/docs
 packages/**/typedocs
-docs/assets
-docs/packages
-docs/reference
-docs/contributing.md
-/site
+docs/pages/**/*-cli.md
+docs/pages/assets
+docs/pages/images
+docs/pages/lightclient-prover/lightclient.md
+docs/pages/lightclient-prover/prover.md
+docs/pages/api/api-reference.md
+docs/pages/contribution/getting-started.md
+docs/site
 
 # Testnet artifacts
 .lodestar

.wordlist.txt

@@ -1,14 +1,19 @@
 APIs
+Andreas
+Antonopoulos
 AssemblyScript
 BLS
 BeaconNode
 Besu
+Buterin
 CLA
 CLI
 CTRL
+Casper
 Chai
 ChainSafe
 Customizations
+DPoS
 Discv
 DockerHub
 Dockerized
@@ -19,22 +24,32 @@ ENR
 ENRs
 ESLint
 ETH
+Edgington
 Erigon
 EthStaker
+EtherScan
 Ethereum
+EthereumJS
 FX
 Flamegraph
 Flamegraphs
+Geth
 Github
 Gossipsub
 Grafana
 HackMD
+Homebrew
+IPFS
 IPv
 Infura
 JSON
+JSObjects
 JWT
+KDE
 LGPL
 LGPLv
+LMD
+LPoS
 LTS
 Lerna
 MEV
@@ -45,10 +60,12 @@ NVM
 Nethermind
 NodeJS
 NodeSource
+OSI
 PR
 PRs
 Plaintext
 PoS
+Prysm
 Quickstart
 RPC
 SHA
@@ -57,63 +74,98 @@ SSZ
 Stakehouse
 TOC
 TTD
+Teku
 TypeScript
 UI
 UID
+UPnP
 UTF
 VM
 Vitalik
 Wagyu
 api
 async
 beaconcha
+blockchain
 bootnode
 bootnodes
 chainConfig
 chainsafe
+chiado
 cli
 cmd
+codebase
 config
 configs
 const
 constantish
 cors
+cryptocurrency
 cryptographic
 dApp
 dApps
+ddos
 decrypt
 deserialization
+dev
 devnet
 devnets
+devtools
+enodes
 enum
+env
 envs
+ephemery
 flamegraph
 flamegraphs
+gnosis
 goerli
+heapdump
+heaptrack
+holesky
 interop
+js
 keypair
 keystore
 keystores
+libp
 lightclient
 linter
+lldb
+llnode
 lockfile
 mainnet
+malloc
 mdns
 merkle
 merkleization
 monorepo
+multiaddr
+multifork
 namespace
 namespaced
 namespaces
 nodemodule
+orchestrator
+osx
 overriden
 params
+pid
 plaintext
+pre
+premined
 produceBlockV
+protolambda
 prover
+repo
+repos
 req
 reqresp
+ropsten
 runtime
+scalability
+secp
+sepolia
 sharding
 ssz
 stakers
@@ -130,4 +182,5 @@ utils
 validator
 validators
 wip
+xcode
 yaml