From 4c776b5d83ca667a774f9de477c52af30979ac5f Mon Sep 17 00:00:00 2001
From: James Taylor <jamest@uk.ibm.com>
Date: Tue, 30 Jan 2024 18:51:52 +0000
Subject: [PATCH] [WIP] Create doc site

Resolves #66

Signed-off-by: James Taylor <jamest@uk.ibm.com>
---
 .devcontainer/devcontainer.json               |  26 +++
 .github/dependabot.yml                        |  12 ++
 README.md                                     | 161 ----------------
 docs/assets/project-icon.png                  | Bin 0 -> 16206 bytes
 docs/assets/project-logo.png                  | Bin 0 -> 3770 bytes
 docs/index.md                                 | 178 ++++++++++++++++++
 .../fabric-operator.md}                       |   0
 .../hlf-operator.md}                          |   0
 .../test-network-k8s.md}                      |   0
 .../test-network-nano.md}                     |   0
 mkdocs.yml                                    |  86 +++++++++
 overrides/main.html                           |   8 +
 requirements.txt                              |   2 +
 13 files changed, 312 insertions(+), 161 deletions(-)
 create mode 100644 .devcontainer/devcontainer.json
 create mode 100644 .github/dependabot.yml
 create mode 100644 docs/assets/project-icon.png
 create mode 100644 docs/assets/project-logo.png
 create mode 100644 docs/index.md
 rename docs/{FABRIC_OPERATOR.md => tutorials/fabric-operator.md} (100%)
 rename docs/{HLF_OPERATOR.md => tutorials/hlf-operator.md} (100%)
 rename docs/{TEST_NETWORK_K8S.md => tutorials/test-network-k8s.md} (100%)
 rename docs/{TEST_NETWORK_NANO.md => tutorials/test-network-nano.md} (100%)
 create mode 100644 mkdocs.yml
 create mode 100644 overrides/main.html
 create mode 100644 requirements.txt

diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
new file mode 100644
index 0000000..fb66949
--- /dev/null
+++ b/.devcontainer/devcontainer.json
@@ -0,0 +1,26 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/python
+{
+	"name": "Fabric k8s builder",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/python:1-3.12-bullseye",
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	"features": {
+		"ghcr.io/devcontainers-contrib/features/mkdocs:2": {
+			"plugins": "mkdocs-material mike"
+		}
+	}
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	// "postCreateCommand": "pip3 install --user -r requirements.txt",
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
new file mode 100644
index 0000000..f33a02c
--- /dev/null
+++ b/.github/dependabot.yml
@@ -0,0 +1,12 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for more information:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+# https://containers.dev/guide/dependabot
+
+version: 2
+updates:
+ - package-ecosystem: "devcontainers"
+   directory: "/"
+   schedule:
+     interval: weekly
diff --git a/README.md b/README.md
index 50e8709..9513923 100644
--- a/README.md
+++ b/README.md
@@ -2,10 +2,6 @@
 
 Kubernetes [external chaincode builder](https://hyperledger-fabric.readthedocs.io/en/latest/cc_launcher.html) for Hyperledger Fabric.
 
-With the k8s builder, the Fabric administrator is responsible for [preparing a chaincode image](#chaincode-docker-image), publishing to a container registry, and [preparing a chaincode package](#chaincode-package) with coordinates of the contract's immutable image digest.
-When Fabric detects the installation of a `type=k8s` contract, the builder assumes full ownership of the lifecycle of pods, containers, and network linkages necessary to communicate securely with the peer.
-
-
 Advantages:
 
 🚀 Chaincode runs _immediately_ on channel commit.
@@ -19,160 +15,3 @@ Advantages:
 🛡️ Pre-published chaincode images remove any and all dependencies on a root-level _docker daemon_.
 
 🕵️ Pre-published chaincode images provide traceability and change management features (e.g. Git commit hash as image tag)
-
-The aim is for the builder to work as closely as possible with the existing [Fabric chaincode lifecycle](https://hyperledger-fabric.readthedocs.io/en/latest/chaincode_lifecycle.html), making sensible compromises for deploying chaincode on Kubernetes within those constraints.
-(The assumption being that there are more people with Kubernetes skills than are familiar with the inner workings of Fabric!)
-
-For example:
-
-- The contents of the chaincode package must uniquely identify the chaincode functions executed on the ledger. 
-
-  In the case of the k8s builder the chaincode source code is not actually inside the package.  In order not to break the Fabric chaincode lifecycle, the chaincode image must be specified using an immutable `@digest`, not a `:label` which can be altered post commit.
-  
-  See [Pull an image by digest (immutable identifier)](https://docs.docker.com/engine/reference/commandline/pull/#pull-an-image-by-digest-immutable-identifier) for more details.
-
-
-- The Fabric peer manages the chaincode process, not Kubernetes.
-
-  Running the chaincode in server mode, i.e. allowing the peer to initiate the gRPC connection, would make it possible to leave Kubernetes to manage the chaincode process by creating a chaincode deployment.
-
-  Unfortunately due to limitations in Fabric's builder and launcher implementation, that is not possible and the peer expects to control the chaincode process.
-
-
-**Status:** the k8s builder is [close to a version 1 release](https://github.com/hyperledger-labs/fabric-builder-k8s/milestone/1) and has been tested in a number of Kubernetes environments, deployment platforms, and provides semantic-revision aware [release tags](https://github.com/hyperledger-labs/fabric-builder-k8s/tags) for the external builder binaries.
-The current status should be considered as STABLE and any bugs or enhancements delivered as GitHub Issues in conjunction with community PRs.
-
-## Usage
-
-The k8s builder can be run in cluster using the `KUBERNETES_SERVICE_HOST` and `KUBERNETES_SERVICE_PORT` environment variables, or it can connect using a `KUBECONFIG_PATH` environment variable.
-
-The following optional environment variables can be used to configure the k8s builder:
-
-- `FABRIC_K8S_BUILDER_DEBUG` whether to enable additional logging
-- `FABRIC_K8S_BUILDER_NAMESPACE` specifies the namespace to deploy chaincode to
-- `FABRIC_K8S_BUILDER_SERVICE_ACCOUNT` specifies the service account for the chaincode pod
-
-A `CORE_PEER_ID` environment variable is also currently required.
-
-External builders are configured in the `core.yaml` file, for example:
-
-```
-  externalBuilders:
-    - name: k8s_builder
-      path: /opt/hyperledger/k8s_builder
-      propagateEnvironment:
-        - CORE_PEER_ID
-        - FABRIC_K8S_BUILDER_DEBUG
-        - FABRIC_K8S_BUILDER_NAMESPACE
-        - FABRIC_K8S_BUILDER_SERVICE_ACCOUNT
-        - KUBERNETES_SERVICE_HOST
-        - KUBERNETES_SERVICE_PORT
-```
-
-See [External Builders and Launchers](https://hyperledger-fabric.readthedocs.io/en/latest/cc_launcher.html) for details of Hyperledger Fabric builders.
-
-As well as configuring Fabric to use the k8s builder, you will need to [configure Kubernetes](docs/KUBERNETES_CONFIG.md) to allow the builder to start chaincode pods successfully.
-
-There are addition docs with more detailed usage instructions for specific Fabric network deployments:
-
-- [Kubernetes Test Network](docs/TEST_NETWORK_K8S.md)
-- [Nano Test Network](docs/TEST_NETWORK_NANO.md)
-- [Fabric Operator](docs/FABRIC_OPERATOR.md)
-- [HLF Operator](docs/HLF_OPERATOR.md)
-
-## Chaincode Docker image
-
-Unlike the traditional chaincode language support for Go, Java, and Node.js, the k8s builder *does not* build a chaincode Docker image using Docker-in-Docker.
-Instead, a chaincode Docker image must be built and published before it can be used with the k8s builder.
-
-The chaincode will have access to the following environment variables:
-
-- CORE_CHAINCODE_ID_NAME
-- CORE_PEER_ADDRESS
-- CORE_PEER_TLS_ENABLED
-- CORE_PEER_TLS_ROOTCERT_FILE
-- CORE_TLS_CLIENT_KEY_PATH
-- CORE_TLS_CLIENT_CERT_PATH
-- CORE_TLS_CLIENT_KEY_FILE
-- CORE_TLS_CLIENT_CERT_FILE
-- CORE_PEER_LOCALMSPID
-
-See the [sample contracts for Go, Java, and Node.js](samples/README.md) for basic docker images which will work with the k8s builder.
-
-## Chaincode package
-
-The k8s chaincode package file, which is installed by the `peer lifecycle chaincode install` command, must contain the Docker image name and digest of the chaincode being deployed.
-
-[Fabric chaincode packages](https://hyperledger-fabric.readthedocs.io/en/latest/cc_launcher.html#chaincode-packages) are `.tgz` files which contain two files:
-
-- metadata.json - the chaincode label and type
-- code.tar.gz - source artifacts for the chaincode
-
-To create a k8s chaincode package file, start by creating an `image.json` file.
-For example,
-
-```shell
-cat << IMAGEJSON-EOF > image.json
-{
-  "name": "ghcr.io/hyperledger-labs/go-contract",
-  "digest": "sha256:802c336235cc1e7347e2da36c73fa2e4b6437cfc6f52872674d1e23f23bba63b"
-}
-IMAGEJSON-EOF
-```
-
-Note: the k8s chaincode package file uses digests because these are immutable, unlike tags.
-The docker inspect command can be used to find the digest if required.
-
-```
-docker pull ghcr.io/hyperledger-labs/go-contract:v0.7.2
-docker inspect --format='{{index .RepoDigests 0}}' ghcr.io/hyperledger-labs/go-contract:v0.7.2 | cut -d'@' -f2
-```
-
-Create a `code.tar.gz` archive containing the `image.json` file.
-
-```shell
-tar -czf code.tar.gz image.json
-```
-
-Create a `metadata.json` file for the chaincode package.
-For example,
-
-```shell
-cat << METADATAJSON-EOF > metadata.json
-{
-    "type": "k8s",
-    "label": "go-contract"
-}
-METADATAJSON-EOF
-```
-
-Create the final chaincode package archive.
-
-```shell
-tar -czf go-contract.tgz metadata.json code.tar.gz
-```
-
-Ideally the chaincode package should be created in the same CI/CD pipeline which builds the docker image.
-There is an example [package-k8s-chaincode-action](https://github.com/hyperledgendary/package-k8s-chaincode-action) GitHub Action which can create the required k8s chaincode package.
-
-The GitHub Action repository includes a basic shell script which can also be used for automating the process above outside GitHub workflows.
-For example, to create a basic k8s chaincode package using the `pkgk8scc.sh` helper script.
-
-```shell
-curl -fsSL https://raw.githubusercontent.com/hyperledgendary/package-k8s-chaincode-action/main/pkgk8scc.sh -o pkgk8scc.sh && chmod u+x pkgk8scc.sh
-./pkgk8scc.sh -l go-contract -n ghcr.io/hyperledger-labs/go-contract -d sha256:802c336235cc1e7347e2da36c73fa2e4b6437cfc6f52872674d1e23f23bba63b
-```
-
-## Chaincode deploy
-
-Deploy the chaincode package as usual, starting by installing the k8s chaincode package.
-
-```shell
-peer lifecycle chaincode install go-contract.tgz
-```
-
-You can also use the `peer` command to get the chaincode package ID.
-
-```shell
-export PACKAGE_ID=$(peer lifecycle chaincode calculatepackageid go-contract.tgz) && echo $PACKAGE_ID
-```
diff --git a/docs/assets/project-icon.png b/docs/assets/project-icon.png
new file mode 100644
index 0000000000000000000000000000000000000000..7266b044e26078cd482c174531cd65188e87b7f1
GIT binary patch
literal 16206
zcmV-UKe51xP)<h;3K|Lk000e1NJLTq0077U0077c1^@s6tyr#}00001b5ch_0Itp)
z=>PyA07*naRCr$PeF=D6#gYH7`i(9hNWSoaG181MU<gMX4qG!qAkD}&;R+ZM!U7u-
z639g^5)#7S*(94yvLOc~*@TdDlMozWfh0yFnF!Cw=2%0>1_MSjlCc3B<NJ^_n%DLJ
zdNguudEPPe-W;;k-=`1rO?P#5byvUc>Z)H6#!7xAKma(uU5ruBp9IwO<*|&djywu?
zjC27ckY@$4JAxb)DaU4Zxf-iCCV>)Bkg<s{lEBy=P~5dKrXWR<|JcGWlHjxKHnW0^
z&0dyb9IJk$N?_~@a-`1e*tlGgfGq{F^+B;!$rYY65^>tS)Asor*%;+qCE&)K+ES2Q
z860ajnkC@I@*2(KAL88=1sN0N=wAp&`UrAeqpm2(kuKb^@g2Pq7*mie=04Y5D2pz}
zs+O1p#uTK)CS;7A(vrZKf|S;LjBztU0>%DnANdMWYzdDo`B5!_BVR#A_4FLw%$LI6
zHl`p)_ZrOO=u2UFJ0ISdf;gAq7=;p)fLrQW1O;)6^%9(wLb5a_#)3$@2nte=ag|0V
zV~g1Rc_^?<#}vf<DIBAC1WBL-6{Nsh#1S-^c7{^FcyWas9IVs_v~gwn;5de-N@_Gt
zvOG=$<_Z!gG0S%_;S>Vx2kY0xqAS~uR_KWmR1iDUJXYsW2^_kq%$v8gynoV;8N$QI
zL3)mpz-$5^htwZU0(b&I$1pIFKobEz20*!iRJXAZi{no|{%lrKKSK7oF$KwL*0Zhb
z&MIkYYVxe#GqJpKQeT-TSyk3I*kA5py-d?EMQ6=NOg;!Y0pNN7bHSKR1Yw(71xsYQ
z61dGHtCqgf_2?ekG#yoRM{bT-NH-o+5I3ag295di%Vw8XA6ub$W-#+~5X}H#I)G`!
zm;&M{L%Tn!0jRIQB!H^i=-LL2BuoBwysQ0-HtHTxRmK#=YC2P!Sx!3|Vd+xQv~?@(
z*|Uds9eb=u_VrO>kLTFRadaZUbBV>tEN}`KYUiIrfM&%`F@I;!mGMa1gT>^b(0vy{
zL2_Dbg_euG{+2G)YPas2rXe|%be_TjlOe@aFds{VsS=n<z*K;y0CGA&Qvr;#N4)fE
zG2<1|>D{q4ZQZ5ET{axqUxP(ZkZcBGQP=)B9d$alscEV%#ax!2lR;cBKy#(~0uaps
zr*?gH-XH$&@V_1PSxSu$x}q>Z;aH??Q7Q44PhLj1g5)5XdGqF#@0u`kVwHz$Sa@n!
zo$CqJ0&)^FO^3j-%$P;MOr-w!Sb!$v&{aX2Sl+Mmzy&eBQog<V-`A~Mp2!3Fk|C*-
z<A_y|+OwC;Kt=Kd0rnEe3&II03lC@}SXMAmIi*aSR1UB*ajL%~Rvs>|x*bVLS8V8N
z`>V@zb0U||gTxWBAWmou)oBu+gFrnbjtAj*0><Yg?NQl?)zN1k0A+^V3&sEw_5<iA
zU_XQR5NNXm@6-req|~+(%boC0KePUJYREcO5Ya*qT?_D;0Lsio!Os&st=*9oTk|2Z
zd@lMSe(m)z>J=pQC^mW5kBRVsd`wh6Xy$e-;z5Ak1n@e54PbtYncrllO(f)ICeLn7
zVqdb1_LUDL2KS?^@0f~##JXwI`mlVtZg(8@fyL7#<QEA1X{$EO{IK*4Uenvz*>6>M
zwEk{GLF{Q-&H`{qzP4#mt)}apfO;q!wMC|P|2@puON8wJUS!}UV*RCLLVIPy-c7G#
z-8u(n{;UKoy#CO=M7Ta}d@vI103<#f>k9vB)JoohaT^L!+C%p?guXxm|2|sp56svO
zmfvPgtY(3?Dm8uU%PUtZ1u1IUo%(YZAH(JPqX5pgIBLbUq~5rG%@gX&c4QSA<(JZv
z8X6`Jit)V!OfJIABmpD=8U$GVTbXy2wJV#)zHZU4x4!!9%6Jj@x9rmEZ*C#d9s^Km
zek`QtJ+k8b!nvYYvhG@iQT+w+`GcPU(SN!ojgf>H2@tk1VGA*B0eCZ*w}9wvW_p{5
zcSuRw1oI9q)2m3=77*c12Bz5INitv66K(%vvA-53yb7<s_2WdWWb84l$B;z)weIGI
zuVC3SbzD4R%Hax<)ls#0a+tlKb#l3fR}gTHB^QTof6C&+NEv=o#~Agmw~6^>5WNbC
z^$cDob!}bm@e?;@bHP=7)cJ#-5k%ige^HECWBel)4ZmY#g;Es1FA(}YfcIL+xu4|V
zySlsn`eG@L!E%ilRIvPll<Hu;{?-;EemH%sF&n?K_C!IV7mT+6R%Xe!G+-;s<lB4p
zdNyzQdsvxBT`BbqE$6WiVE_|N2o4g<P<OPW)0Iy1Or*Y{^;Ajn&qS7nkd4fGOFX)A
zeV$n=7<o$tDGVpstD!Ftx*x#RX8bWDqCvl*Z06)m>y|Gc%zTu|zHhTWYa3e5(}WfV
z*jPcBqQ`p%F6iv+RCgEmin~KOm@o1*G&eD69ae7i3|^i{?!A7~nl*jy4eW4A`5Wq?
zeU*rUWG70sqe1ZB*!Wz`%=l9hW!JwJ{qv6Os5`6e^#?yqLq{y5%ev0M=i-s@cMqS6
zq8hF&2k!HSz6Qc=hd&}7v|QD_jrkL?uJ)f;5_G+S`)V^96@+|&(C;kH#Br%7FYH<U
z#0J;rz=EJR5PFJ$b4{x4NfOT3uqxbBXx^OmcicJ6Qz|ONp9y3(K6SC%C&3r>M%tfr
z+Goc0F6x05sZpmO^?~MjOj;O><BWvQOh1f!25yDhM;MFQ_BAwL0O9EX*f5%pnST<G
zwtplq3&(({)gs7-mlGRXPSIJcOgnR?tQ?sZ5d+WYpvyKy+SKd+s4b&TL45wuCqTH%
z{Jnwwu}FJYA!jA!@-k)Da|E1f+%NBx33+nQ(<`^6>bSXb3piL`AaogkU#6oQGxp3N
zomk!zi?-idK-OIEYE&u6{Q2|Cc8r^{mVm>|qX#6zh{U4dM%N`}_4V*KF9K;REUMib
zi-d0~G;ePAm!5}j5}+2p=^7$QS9f={skfd{`93nL6vXQfzK@80YceSVL~=p*s*dN~
zUKD2ZQVXVP@{ft=MzgyISidS3UHNz+dCON{DOZ%T<h>xeYPb)B<JN1s&X@MCZvUGl
zFD3Xz9UTfn!0huDRF!)s{Ea|!jRZ}M_Sv4q5;OB@KIXu;Fmx<y_}lQgJQIHm{C(dp
zEOhhD#c;tbTPEhc_@ZZLyx%j<lk_CYgjP<{!@5poNnL;WnZORf`HQ#m`~~!O2F@^B
z{LE;t++O|e(HLMgIurzeH_&<!K`u8z^3WOlv3R8Yzbtnumn--J!7l^!Z>D6Ku8&3A
zew|C#CQ41UXE#mvREk*=Wittw#mvWnaI651<y1U;>QDKqssENK=SYUUtH+c4rVB<4
z^7@;b0qqeYt5|!!hbDMF+r47NKrS-K*d`yl-H40fs8Nvm#?XDtrZFFT^!~)$-e)^E
zyEXwf2zlqXRMR-2f{u)RmB8^>q}^wOoN1Lg{${TSS`!geK+}A+b5jcXCk4AQTx`uL
zk-WNlRmTHPc~b4`{H@msVk?(-r5HEFB4PEwJ8Ft8VHSHd>Ql~0u1lkWWMqd~{zp98
zal1Rb+TNPT*BJT?7~eMOSC^n$dm?T3IN_}>5V}$We#x#yO7c3Eyg1&~@tPC9RNJ9T
z`{dsd=n9KVdpGIYqVClzVov)kRQpk(AihBGZh$^!EEIZsZxz>W3A^W0WoH7E!(@df
z9|4iyus-t!$y#eq*W<6)p=ngd>koyA5OhLgL|X=9b*yD!qZ=N$>U~5?@jM6>W;`<Z
zRqW@p<7+#1xj2@*ktz`dG2XFj&s$WhmC2U@L%}Q0+`D7Z_D|+bN(O{$1Htn(V1+rt
zA^#?(4SvAMdEeU*d>09ND$7_Cd*UE`xn|$CZ?0XtR{5%BT@IePx<K$+0lHVkkC+fr
z^L1BjX3gib^_0$<ITsp~h=Lf7#Lf|B7bIOCD+0oX*B^R}2=6wV2ch#>ui7zj8WRz|
zKqv}efeZ7UiNrRUOfKnJ^TabQ&==l7@P`C4^%PL9D8%}exthFfAAqwQP$s%1tsv7w
zq45*?prH2~OvbuqAi1YG-`=Am`%mxc=7{Hvhhx$3d$OFTL#lflTKptLhshVz3Hjl+
z-ThkPg4a7cH#sHd^)H!ANd5%`E2G42=xB(o4*$bxpZRQG(h8FDZ6fV)kRdcb2=cP-
zNXH}j6w+a|o0>dcz5JI1yx*u_X6$E;7WF*Y7CE?1cDvs);SF?sn?Rqkda-t4{EzT{
zdA%EVgSv$mhJ@x(p}IyX6^7Vltl&!dzIaFJ-bYGSK@{Zw#$@@EAS^VVe11L_X@92+
ziz6!%wF^QgYo64XZH|e8M3N}G)QP)&8aP3D1$eV!Ft^G{$$V>1wEahJgaCW}p>Gi3
za~Ag|X6D=DGi&~{RPQ4tt02C{(1l>EG@0upGu;%Aw*4Zv^^kijuRr)n0^J3Z92^XM
zIvxps&&gt|^9MgFi0&@H*JD^1J0$UYdselph)74}_=e!Da)Cbqbe1_G?gQupu}Jt2
zPGseXS(C<xDoA$Ue?ziP$*8Z#reyiAm~f2=@7+m4$d$N?Y#3g;RP%1$)lEQcX5Lhw
zJNIF~oayAal0s~u@tcUCvOi^4azmyY?qj2_iN@Z}$9uEu^zhpCf#CVf^n}?)l5Q0v
zU284H_mPtPf+#3a4@1RkA9RE{bQLr3<M@o~j~DvWT-O-7Q80dHws@Fudwf;+Kb$PE
zx<K%QX_KiFGWOaYqEI9m{QGz$e4QH}xZXghjew9DBLwV&lr7y|9m<q#TC&;8tZ3Qk
z$XY=P#?e37^)-e*d)Vvrp}XR?fn@TGO$7!kQ@eUnj9&w@m=DGqMB157Fl*CzUk?$`
z;%Jg{Z>*4Bz7&syzmYqMp_cW5(5D!w_#LwnCtVATeL-wW+ZPDl%b;onybR)<%-99S
zb^)<nf_LcDw{}A$Qt(JMUqfgy1eE`hNje1nS<U|Kx8(ZpHm#{?!o+0xXNjQFoml`#
z+Z1SS)%KE<K|8y;8ToXGf(nr~Dg3jTHh8m>$JE@0Xx+;C3t~;f^%}G0Up#Kyu}QtV
zuTL)}p?UqG`>a5+r9`NwE8L!oQ0khSr&EIdiy+kFqlxolF4VJb!;<Bfd!ij*&${J7
z4ZMNiodo)d84byFW>2*31t<OFt8GatNWKQ^gzoGG7amvP@w{Y)cg2hsDz|SsXPptq
zbW@Y(xcypnm8ZOhg<iwZCo#k%!E^!yoeJ>9u!+j(WGpt@DqpQTW6|)}Y}P-lT5VHP
zrO?ZtIV=M7;FML&55=SH%E_@L%b0@LoEEP?_%ri}L6TA?n|iud9`Z0aOula6g(r~5
zb2mxUF=4#QU!pv7X((r58YbBe>`%cih5cZ<JQi)sIRet#5PCle{Km*k&8gfabU{y~
z%?&pfn=_eRwJ`;;Aun%Z@I+$zU%=Glx;hpKE3e*6t6ZfMc-&=gTpOI{UWFMiC-gn<
z%+-Zw`stzZ<B!1#A_Pphc!Cnz<=s!O*quA4`EBWff)rv$%U>UMD5t>SK;Jg8=j#ml
z*?6QwJq#Xx)bNMS6@;!*PxE{*<5KdaJzec8{XtG;$cKy`1E|J`fQ0;bPo(3ArT9QN
z%(Dv$l9T-M*@))NTUv%=x0df7s3<QRmn;*5TDjB*$9YgThY2TwP|si=AQ(E|6k8pB
z%ZQ=0%S!}=^GulD#>5NatJ+^Zyv{OF?_Yf{kERS*j2Gh3u!>sDx%e7`-v`qtObF~L
z8_?@serDx1vrfDVo6n99?ED*YbjQzm0O^LKQ$d=VJibKvWJ!aQ2--9jVg`t(6XRG?
znQFn4m}oLF*MMjeF(xsgI+I_JWL(k{4J*gGj3u2TL&5o&!T<jx77gE=X(z00T3oB?
zvJGHEunDJ==w^EYlFax_EE@hnu5@dgmdp^z<cmb6d0TFaMZ#v0m`H&HLOdynzR<HO
zd|$5oIB8cZ3X<CO_aD1eB=$@c6`uVQ;lW%Xgiivq1W?DI8DPvNN+BvL00PIn6L=pI
zyJvMj{j|{;Sa<`iFOliu=KjH*eY0Nszi37b;5vVBsQ}$?!`;HkJX*K4>3+h%oBE(^
z-tbh1ve@NRyn)bn)0kNq+p9jxWaUZ533pNlU#bs;9%T&0+ekr;BR!*YVlJyj<b083
z)nBH{^XHfOs-}D%lzKHj4&WJu%S$dl9*cAs#)|uFfx+?5Vv+U_8OT8eJ3V2Y#>}x4
zT_YeFzwVh?{efIvc+wG|%91zRh$%a6LOy?JJ_yP%k}mvg65`TALzz0>g`LifFA%&9
zOy4N<4$DAqncR2!D_vbGb@E|F0TJvRH${byszjDXWsj7&!subp*LdMVut!A$TFH46
zh&OR6om(osPaVM10V?QAIs>}UlP7hrej;a3g|x4lf?hH@lIjf68jn0~=BceVmTv<1
z>_LKO0{^x<(*7?_*IYL3ttKuTT3OdsfNRj8;vHsX-Pl<J6&L-3SWCmFhXD&lTC;qO
zq2s|&_`b&*cg4@@+F+=+vvX&rI`x6zwG3Pf&<<wWCWv2WqSpy>v(9p}glFr9$bv1I
zK-^Mh(i&VwjAhED$=Pu2wPxVKcqDwKz1o>;`TQZ}y?cQPjpr)1RWC3DkxPMLcw_{i
zc_ZnlFoHQ+;%?V-s~9j`Tm|vBUI$`z`6{$qMM4sSJ*&d2j3(0O58VNR0)sP@5wpB8
z9_{$K5e;Pld#Sv<V)nLei5z{i$mefu1^5xOs7fab`rx)C@xkt{+%Lm(0v9xtp-g#U
zn_+}m0*iYaTdyHz^}v`3C4Vam{i67jE6u~5T@p$$6-4*~!G{65#HF!hAd}&hgCUvt
z@%W6ION`FhvznTwR_W#4X6WSrUai@`?bI9>epW+P{!9SfneTTLD~p~P(<yZO$-7hr
zD&vPi=4dS1ZuW4P!r0nbHRUDKn0Dr;G*9Kl>pLG)fPHx_MN^P;*y?its`5I*A>!(6
zzkxv;2r@j76hGUvrcLD{&sb9TB9J-*8x>~Bx5T>&19Pet-@ufe3U)P*n~BP1%D2X&
z?cdL3K87HWNJSzV#i1+n@h9WaunOrlEVJg%A6GeU%5JO8fSH#k^unZi%S9fCw6XIV
zeMp0)OEur-T@M1dG{?@>g6{{Q^5CWZ%RoP+aA&y}gkECql|uBAE_<^<51iw_Xi^ys
z{s}OSg;y7R5Qj294CXi@i)KT~K~>IjRwnMe6b8ca8P!X&w_q(3K7ZF;ATq=zV_-8S
zDG*!JroPOk#Ty9Sp1OOPfOV*Oml7ZAad0HG;zRvjlrKm&Kxj&^0G=c88_e{&AX3mY
zTUlZ^h<7veJ<_A^PVAYu`;E1a?YA>%vpT+p)(aq5DTs0+G%CNU*}v^WnT}UkZx(hL
zPHieXzi0`PZI@o=dP!z^eLUJ>5x;S0<DnRqvVWLm!DYga;;X_69n;bybM^v-<UjFV
zGt?NxfqG9N9ie<e2Ngj<mI+^A^+*$5rs>)Z@PF>zMRye>Wxx;z<PC&WB%jKlWK?wU
z;JLBrU)MTYi@CM-20~8~kX?cxn~#KPj@~3m!S1fM7wvNB3xqxn!0_drfxdwO{rJ}{
z+)57aulDSw8Cqr8GXR-b5tWi~k7xhjIqTPU=H)(8a0MAU!X%<YCOpIa_ARh}y*cup
z`+K$W`yowJ?-piwPLISQ;mhspgmxELHudTnLydy@!9#$&4_5$n?0kcO1B-@JaG<PY
zZe=l4)E<pBFMN+3%-*?8O;dHfd>w#k2gWgyABJ+p$vQ9N3Foz(qLrznq3T`8ps>nZ
zm4cpC*kP7mr)*?hlp~hc-*OF+P+6i33o$<0ZE=~)cAz%u3vVFw2LjCA0S06;+2|5X
zrwx`eS4q9_L%UDq0ZG@;8T5C8Y?nlB+8f%_-Q9=h;ix~iX|^mce~^H4tU71Lf5f9<
z74~bo=zNXA4}-}pC(CXfd`YeuZ+(H#d(-(44MDM)AxR<_TOC$j3$B)eenCz@Jv4q_
zH9cqHxc4Hxsm;$c!LE*c1hEu4IST~_XZT5HV3pJoml{0`=99mXv{PQjvV5jTy*cQW
zZyWnH9on+?>?JcqW%3>ZtfKh(CF3eHM@~iA+Zg&GF>Wy#`)aO`OL9d|oHuV?`M~7a
zcLKQG!rNjOOKypGwIAf3;(SI5svzFR(EEw;-zID`NxrGOtNj41j{66x%)Q$IX(Q&(
zbVu8*5IUUCN}eeUnT>ZTlkEAXT`^vaP1NSYBr8;Xp!HG)|Bn$JV!p0B+O8h`axX(r
zufL#_SAua-R=7$namBjM&b_&Jc4*6jDTs2Nm{83R0JOw}`8YIcjdfa^0yELbTA9)f
zRP3~-mpup2DJHz_kO}>i11X%{nt>wG@dg$(6U&ES1x&~Ekcao)VC1u=*st@qd`Xb_
z@<@Pf2CtVJ2hZs3?NoOnN5$9FS`S^_y>PlAA@v9hd^H}e{wlCschq6JalsVC+t~6B
zVp?SuVaDKJ#%I)gFnc?^Gg0^g!5aWFg)o&Y?{JFn;fza{TPw5i8#_J)Au_~d9J196
z;pax%RlRg7=R>!m^cU%;BOE&!kROgkI+VkwE5)}kbQ&}$BZ`XcF(^C;&~<L5dMlWM
z)cJ$o7i1b?mPnF3Z$p7oI1d3tCzVyrIQKg6#z2zZVfOlNwgR&LvbnOH>=E$>LJth3
zPUB2|Ps2psB+$FNBW=p_A!G42w9FwPRAAY#gJDdt9(pypGH#C(d$sBsTCNg8DE~bZ
zY%;urBwb?XQPQf{f+&bW^bndy<$*996f>5`qhV#SC}_fY1qMd~%T06tG473d61S8R
zMwivZ+Woz*;ewNhJZ)x=e2Nw^zpM|+CbJ`E`WU1vNyjtueR0p=N8Fa#5R_2a*9r7#
zlQA-b{xU}!xXh{7Zy^*!`SvTES_Oq~^jYkaNxi8U=2LGV_;UjNt1)YkL~==Yq(fP_
zj>s}}(U!kAPbHT!`2Je=BtG2RX?&-sT^M?=&~O(tz9io1u0?5B_(QQeQ&pIB(Co{{
zjAfJhw*9*khtj+&h>ELV36+5IWD^DH<o$e^6EyT(R&F|KP3?GQ2<p%2TB5;hQRLEh
ziM1i0KlCLK{+~tY!CoeOB)%$a_>NV-cyR^x%2T@|ZGX$>X&{9&rg<JEvr9X$4TP&=
zt8#xI$-9E6^u+@By@lXE5sQRX9*lyO`i9n1S;$Va)Y3><MfBEqbfrpxX0Md;g~Mb7
z%EO_Y2LFdG-B`F!O6@GCS$pjX)4Z0AM@r?QynYu~z3c6+M>9r_TJe#01@ZbrtIWZ}
z=xykHsu}c-)gbKuzD#)ik$Pgf1cE*UkQLI%nph-klHtmJ&!eGc?ZV)hnjn?(Zn`PI
zjEL^>T-Dq87v)G=w4#*SgTZbK^c3X^@F4cf8*@3K<W)gx{Vh!ziNBgkP~x^&mpS~)
z$o5v7bbbBeisUrCPL#=c#0v9PoC2`2pP!V5{;@M|g-v^_6Zjj`aa#={r)B4yXnkN&
zD??X+Z>I6^#By18w8IpXI;SCI*~l9R{(?X^STwU0i;{_korQ8pJG)ab<gz^BF#<K4
zFuzgL67O8!nY$;Zy0Go2n({A1SjvPM#A^3bF%wP!54evZmc}D(f6j8wMs;;HZxx;i
zcflf+b1EK#`MREH`yZ|Rwel&D+J?~8n!x>5eJI!XcqE)P_CeMPV#Ubt@Ac<5FJP&u
z#Wl&O4TJwHKBMMiP96r+CS;YFXoeMU*?4`ctVbkq`KvjmGO*&Mlz*>1v#Ca#Q2qkQ
zI7w-m|2HJW;-1Lke=pW}=A7N^EvwXQps;W<7HQ8KC1wa2%XKGVAf4s(^Cm%Ak|9DC
z@Gq8f_xVF#1>p|MirH64sFz{4USw@`pQpL7)%S=>>eZSxgbA2w)}EOk5}Q5O6xz9T
zn5UDQo2LvW#G95U2Ihxi*`!%W&qZFoAoG?kEgyJuR~$nqh#3nr|L>%}?F*gQsOtlP
zX^blMQfv0An#=k~wPB_o#-nX23eIsUp|x*!EDBZf69iVynP%%m`8?efi-d2pOW4hN
z=@9823xJJ&NZb(XN@da=QOsv1FACxdgw&(pw@d^vC<!fQusb${sBHIN1R>`HFE;wv
zrR&_(ySiQ3^pCoda^g&uKMX>vg_0x)@~ZAgheCtTd>+Zu4l(ov(cUl*a-;RSHgJA#
zXJ^({H`f)Uwy9}`(955*_%uHmi-Z-pSk8yLH0a!40L*uL<&L<k^h({+)U*088{F>4
z5xqPuxRE@i7ohSYFqbpqAKWMXxtLP_*=P2H^7@<S5^1lP9s?!581Kq0A!&9BVuOEQ
zW9WJerAan~o|Md=?1{Fkybw7TpTBhxC>4ib7-^O>@xvNAOU&sWAH|{MZ3r$Qfj?Mb
zCKK^v{eye2&Nb;yE~863FJ?G84N+s}Es5T}b(=P=Q3yC$m+Tb8;`pYb++ItTKSTtT
zYtN{>C0JkJ)XUT75B>#2i?bea4h@t=O9y|XC(>>f?3DxM(a|JjN*_1*cB^EZsq+Bw
z=VLQ!zT?C)nT=Gu{?KoUaE(D5W|m)xJ9w{grXVA@N}F8Qo1F*K@Gl?DMhGM89*+F&
zgqpp!3fLJW&x)_=_&<9sj=Wm+jiE=GQ|Sl{*9|ka>q7cBtjaxof?dg_W9)kkLFNcs
z2y$_^gAfWg6@+|&(8K0naJ+LMsh_rK%@eQN6~f4RL%Z3O-`j|(&b5mS?S{m}%<V~(
zUHw}0&lz)pWYeLI(`q*43Q{+1`c)2s#wa607t6nUlF23O9p2A(h5!H_{7FPXRLryG
zfR--Ryl?LM8WFx=RF@f#Nl)S`Cyu7BDM-qXM^k_dCc6vp<9H-&7T|9wmpXsz8G=}4
zUbTD}v?MlM!Tt*(OU9i&4pJlA=BY$0rV;`XJz&KigYU20R&%`>in|pJv)@$~D@{)-
zC(=`m>N&|-KTOlPf+z}Crl3Ss%*Vm`97giJo5AmiN7~KuLRiWyjhp)o1LSYZ_AXRV
z4~SRCB4I<If{}fU#;=8$oP2?hGT|#6sv$#6h7E?5Cj!$gv1r?`U6A=<B<dPMHwpn2
z=4%uQ*%ga~6~LaO06gak0$^^_#Zz^CK*8P{YBRuV_wJ(eouVXq1EC%QYV#p<yEGYi
z!IMm0l-DDKU1o|<FAWx_-aHmqbiXS}a)I0Tky-OE9#=VTAVx-~2o<Kld~v+1T|EOh
zDy}F<tv~oajYtL27}I0A-q~(Ks0%cINI<AvquAv&DMhFhVj_wqh}wq5=V?M$7{*h~
zcwpdZPUx4qhz3JmfACX8^c|yq8T33Sl8deSwDV<mtRN}Vu3omDK!z7Lm6Tq35@$KN
zETvrvo+(teCG&;HofX>P#ctv+*<I*%Ce<#jO!ZVmpxmclNq{G|Dy)u2Mvu8v?+;$d
zp#Qc&VNZhju2{5P`Q<q->LFUw%as%CI}M33z8;H)71*4k<CUWCSV6r0)@z8^3`$gI
z$dAV(9Y1y=9dAR+dq|`pODmnwaigs(U}$bIk_Q^TK(GNoJ3tx;H^o+ke`VB78c*!U
zu!zS{(4fqGc~4iniX+e2dqVNy3xpJ~xQb9USO?rESf1weoo#r`jud2GQ`3ZjWcdRi
zm_69Javbpmf_DStisPV@b;XQV_U*=er*|nQJml8a-nYl+5B=q!`P?X_2$~%w>zfwO
z=A`~42wqdZm|rK-FX@gvVF(>$XI#EONac+*jPhjWAI78YuB{VC3R2(Lau%~_H#>(C
z@J!!;zGN8s-rh7FE-GIj_;rA8cjK#PXCe&hNM`xLc(lV5WX=KoqBc$EZ5f&SZ?l$6
zzRS!YapHL`r^qr|Z3YUM9@rx_`?oF4)q~p?Xub^4)LUD|!oUvJlV|m;ej*3Ixy&om
zk%Cwyj8Bb%_^CnJx8${G^q-GwIcSNuF?b@F+N>U_^1H(1dXJ<FUg>IA-lIoU8G_Q8
zd>=rEr&(tHeP3VY2aOXHshlrepS6+BTW5)H#e)m)u#;NhU;(E9{>qYVAUe-bL710I
z&){`V?z$ssJ5mr|AT(f+OG6zw*MVqJY*l!p(-oD@JN~5Ithn~y|Lk#=O_n5k6icU8
z+ACIh?PfHgtMtq9Ncg*k9M79q?wfL)La033VpO_9a_o+@J(A7nm2)Z+|B-<4hV4jy
zZ*0{{L&wEz`Wvq6R6*3DpKX5j#D0LTh(+7f>$l_L3k1ImkOE4!9X{!fqL5@M&vhGK
z-?2bkBH;6fJ^|pnCMgEuu}Iiw)?MAX&C^Ah)&at4X7vboA=#f;)cdUc_>6jg=(lX_
zl&HGv^~lQ8?WTdSD>g?8azaDPdpv^fw+eS;#tZS8)$`r(@Km2#S)L3N=v=#lbfq5A
zqp?+O%7Ws^3gZedc_8BRhc=kUp!1(&k#^;%Xj<wTgO>;<Wo0tU@u(czo{Y6LTxjR0
zmHN6tQ>md%@PqaD#Ud*$!5ggjclC%hJro*0p^ufB@9=Z$h@KQcLn2x8=}l{v=j4}v
zFuD3b^E^fh5Tal&>IAwh+haktlTobtK7aE~Anhj^`{&e-u%C%8=!vwccPR5Re}0*_
zYVv;&k#a>b-GG_t3v)aJ-!a3_RS-@*Bl#eRE;8<z*TrVkobJX3?5ct&VyVbJf#=NP
z&s9AoWa#p``05Uo<H2#MUD$f5(D=8eXHv(#{F49;(){kHjM2?q>?)6>4!4eY=eJa&
zN^}z8OyiDeWra3yncaucbf~V%Jz^2B!*5GYw)8~*`hrp4-i8)`8a3VscffJXhnc_~
z9kGT94?QlCx^!8&9rUoCydXC-+@Zr5nuN0Nf#}0|Tu}!|OC9I;tPZa#L|=vM!`m2K
zLadI-m}u0m1U}J|B{Xc>>stA1%`qJh;UBv21dUJ{eSwh5o~yFx8kIeSWRu<Zm23^D
zt|&+<U!GoZC&23RY*p6iT4ISCdH&MwC+Z!>^|<trgJAHt;t>mXiEO2BC8>P>J`_{&
zS954s?t@OXhS0D^V_vpQ)UE8gMu05SuQB6y3BCG*Bah$p=bn2Emsh_E97tB0Ng|KL
zw8WKer&$>8$gzS9%V%ms!^CPD_XLREWihWh7|UWV#Z;(AD!ojsw8C$4zSejz`e|P5
zS?A_z=e#(la6)6Ku8i>mMk+$kut>%oJ<;&jbM4XV58gvWDh0G=LZe?YeYhvO;J<-o
zDgP<uu{*A+{~jij)D*x#a!{VN;i-H@FAl-RxmJckZndx#C^P}vnQ(DzRd}`I&ebls
zdH2T&Y;2=<+)0`M<JWzC6*n6{n7P%F+jN$Rx^pAbQ0AE-i0has0Pqr`6jrf`2R3#O
zqO8_Q1ZB#(Fj@An*#lo{w1jPv@pEQ8s1bVzxRHl^yo~uHJRDmUevjMII+&iT3Ze-6
z8ba4Y@V!>1UjTbp%G2Uq9j`ea;Id`H*Rfi?vNi+k`k4O79}h~#`+K78%N_G<mw?@4
z+tQ_4?Z!RFqbzw65h(<F9|-lttllo_ER*A8=I8%nGpf&WY8|R;XblL#>JhTa?yzmt
z8(@;x#8-7ZWTS4*Ra{?8>herU&-Vq1o2<E_-_Qj5Q1^<*)r-8NlE%qWQGQlIJQ@2@
z;Ksz90MQBNjPTn@U0$+b^~yDl7<Rd_&mX!20=I(A4JEd^{pZW-i?JEiXE;@m)W+!#
z-2}q--SfugS7ky5tYSWFjn|}->k2a5m#;Cn25js%Gh9!weE+M_j^8;Qh-zOSSUiuR
ztA#t#BBQ2!_<?Wu-zo%nEkKX!`|17-YunybH0u1JI|Sk1EMn`QDKFQTyu5PdHaGZo
zN@FO4uy7qfn!){*+iI%ah$~OUne0jaf{5OC@OX3ea$t$u<6U7D=AGA)Hw8)Cuhouj
zYWfAR7gE0@*0s_+k4Q!_WU%Y2Y^x*|fl$rN%I{|{f%|mEE{{e#nf14YHtwzUP4l;B
zdc{p=TKaY7%j<#ulFa;_c(mORQ6sOjb}(@p=pK%EVfnRKw8M^d(y|-na7s*J#}B-W
zHwIC5nv=VcC9~-Yc~cOz1N$0+H$l*USuw-FGXmPXyCW;MTGcJY?<%h%7%!T=4FE_=
z;C(%ju*#27w30S;D?9*|ASfRt32;*^(yrn#9G4T$YdOVJCjQsb6~&|{W_%?c4KH)d
zj12<$RFG8nUVrF5B3y4_=2OY)e=0V6K3Oan{gJZro!@)`r00R5WITptBXlf@tq!Xc
z*F`BQ7#`65=6*^xSTjHCJUPf^m%FrMlP?gw10a<!)XemonQ6ur32N<$wi&*@+Ze6w
zDtT9sbi~;TD-X{Uav|_JQ<rMn!*ZeG(9z`%BAD$|YFRxRi-eUEW5LT19zgj^1k~rX
zbB0cYA9P2;X1U32voQ2#Ha-l(A+a6y?j!u?iWxQUS+{(-f?vveF|#qd=C@iOSbRQ1
zSCL?b*{0GX-3Z3zv1oX0-bZeugIV+EkE<Lv`C$SD%`WW({?cr1@LNuk*4tp|kSg^J
zEmyG+uEsxD@bJD^B&<N=vIIjo{H|Dg_L3P|<zN>;=ApWWG9)4K?pRlNMYgiawSL~e
zAj6D#{Vg9L5<jv)V`t?CUDLNclxtXKu7WUXmrl~7Vp)t)G*mwBB%K#q)7G7$WB2XC
z0kbJ=sH*<^iO38n+(8eSn)3QVmWyADu2e~j9GCjWma8O-pJ(B4x~69Tw(|?QHgZys
zT;_jhLI>_OLE`?Wz?r{O)3^QhLJGocw(A2etqko4fUE#$5I`RR8<_Do6?4CLU*A)k
zpN|yOz)%-hbh?04(3{g7uhc9EFk`v&B-{yWZEEuP^s)y5y5s;0#^)@RsrK@CG_0_=
z3RZGbkX*S--A8m?nfXq!ps|}FuZc%GN+rWA`5HsBlYmDI==-@!-{of9a}M$pK7Z&J
zAY7M2Tc=Hi+{<T9`r7aVVlErzFcY;6E$3-M*m!j1=b_UgL#IinqcUh;Pz6yu)HYmj
zk|sPVcG=82q^iEux4+_D#q@j1dg8Ngko~Ntv8X-=kb2B4R@uf<UKa1_h`PamFA&^g
zm7IrxZ^R?vFBLkX(_ICzvp|+Apz9qs1LAHg;S%s*xt6%WZlI18z0v%;x22_8B<Ngb
z{3}4pYUUb%o;~Z)VbWWpZ%ka++uPaiRIc7YXd3~Ojp(QseM*XV9Ju2-?a)s9^jdaT
zLF{y#uHy@|+z*JWEt(|3_-HH|&I2B=9c|8HK+dWjn1?xje~rc!rwNF8k}yvY%>(0f
zkZDYWv)*%T%}l{~v`yWEaxS%JH_gy0%TsPXMny7y+7k^IBrt9y4@Fau*$Wm_RcI6c
z41!ALX;ylXOax<VI)^MoqpYZLjziVtL9J}65IjXfP9>(v#59$`Ge9(51q6}$H%R3?
zQGR4ao0n|F%Tfj$9<!(}5c;M7R957Sg@NrtPoC4g`iWTP8u{Jm@-`86*sc$>zLSAY
zfDOYv(?W?=Xo)jR_^3tofyGmq22Nz@IhjbF42Tn%aUv0>F`(ibR4$F7KZeKg%Xc;_
zIUjWyFUDp%^Yry9zd1px0Amko2L4#Nt@{0LI85duhP)|=U1q$2)+>nl=O7$o)<#{@
z=4gpK3-uUx`stzZ{o|80(nHmdbPNQlnM4g(9d+dK44O$y$AMC~U^4+2feP3a#b~Oh
z1M=2bq~jhZOs6s;OZ?OX9bR3Ju8Bp$uEY7*<-6z#qK*^ZhR_#Cq+HC6Qb()t>;hql
zD^Z9CN#}$>>r4*~)=61bPvANb*AvJGa5X^cB3ubV1v4sX=wh6`|B&6;7&Y~HgOpmU
z)BGsDKx+rU%_hU%y0;2-Tf*)8TyyKlQpTmAAW&d%C?EVSLzu=#GkB*2zt=ONth0N?
zii|;4%0H<WnBeKdgrq2+plKMdLr&CKOo!kTz~lwt1ZLDKpfs`qILlI?M@M!3O)S!`
z!eO&?Ir*n_>d(9Iom^J-EWk!!aLf|_67LF|rPj#1xJyDo)F{)5QB+u_mD~0XFghXd
z2ZCJBkX2G@J`&_53AOlVF>nllCn(!G0~089$06HLrFob7DDFVz`hYIajIVK!4m*V-
zu=7a*sazyR<;CN*#F>RUQX4T*Fa@!5X;(p3An^#1u}ypwudO43b#-ZuN5V^;3?_}E
zrr?^4V$_*I%i@u?Vm^kZhFCBKu_Mq_4)n??pCJL2#r9|}ta4ot@FoMVgRqGt-T+~D
z8Y3!X<4c<l`R&!g@9vGXD}?=A3;F!PZ-Yp=&SzeKjNL?ZL3gBhNS4DJy88-Z=Tl)J
zTAx3tuvjlIH3iOfML-=(C>8IbtGE{$ihWW4-bKu>fbgnh^b&C|l2~81y|4F`SGx9?
z_2&%)KSEF&3DxAxmubVpCz2Tv=^1xPZ|DE)%(c%nEa^W$Fh+`JtcXR!OLFbQ&35i9
zhzr~)`#1#si9qjgfn1?TBp6UG6K@093h-MP`uAHY95B!}25%M6cj!8{?cFK2ZC%&7
zH)rM))X~b-mjL{`93g$O?wTP#6_0d$FYAT}HK_9kKPrgK%)<i``Z+z3m9B$O<idAJ
zDu^0Loj-K3ASi5CTO~(-B3rZ%sl?a<;+Fxu3h;W8^h$!t{~<j4-lzqVozv92Ab{n|
zhtX5=nl8Z?2;Klt-c!OcWB;D*iRn(1div?1@e`_{HV(7Y2#*viLNn81C|Lzj%+@yq
zzrupPXg8x&_N#rk1@{4z+W8s$HYp_l-eMA)nC0u5l$!=U+UCK1+qS&1cJ2P$`*FYJ
z>;+4!Dm=UI1Naa)9rt^}ZLvuB+ji(0owDm1LN^M5pBdBOJ_i3wJmO9U06V-|)p12Z
zT)1{*<TIUr<N<(OIFIrmgI)*l8Zm8_BwrEC-7GyXiE?@qItG$j-(X_m#Kg=u-WV*E
zU@g-LObcG2urT8v1aof$tHogQ`^JRi^ENuj&6o<98`u8;!7R@QttSY7si4~^dAOn=
z4g_!6)O&vO*^rt_-f0!jK9ZJ#t62`BpK1Fl{=R-~<qlxEx*Q*oMVZKj5Rb5l+jy=6
zXXg7R^=-e|$)=G`hoI6&7`qg){BkVX@wHs}%tyPzDoAdh8meyyUd#f2%<8d^_&a_3
zD(@_2z*Rmb%!K9;oDS16w;ds+&aFMG+f^iJ&c*8w{njGfdaJG_=DLv<BWETvG|Y>F
z<faGa!}9uD?;+xw0kb@H2Wae-dh#?k67{$#>@+Q^KX>s&pzj!}@JwVK)k&uQaXV|)
zIrUhrZEC6!dYQ8RnY~bFGo(RgMB_87gHG^yRmwaGO<AQhg9XPd`K$4+c7>HyQY9}6
zl8+G%p&fFERceKF-@8fEPVMeou_+(CWJ^;WF9<xJh)x1n{Y?Q#9U0Z%<Wzb(#+T#K
zutI%tREFaIlPhh?N%;V(HyV}0eggw<5cBH{QUOdGiSg!uq^CEnY1^JVQ!0o0YGoQW
z%o4@GW@cJcC@{Ee#xiOYL=CEbLCaa}5ejD0)HPn!W#%u$qwU|!Mi}|1J8$07^8U#?
ze@{fFc`Q=Ec~UmTyE+uarz6vF%0v#n8$?xL9t4qc>{LE%uQ72CL-YtvcI&#<+qVxJ
zxBNZ4FCSx1&DoH`wgEKHxDS4mCU~wgazM=&Z+7U8Dg{vk^7@0HCZd10z}He$cN1w%
z-K$nSZ$}XMtTU9AS3GG6RKa+Wq;_fd>J<jjbG9M3XpX<RuADtpC=<K(Y}a>e`FmKI
zryVI?E;6d~w_YcR?=v&iGx0_7RqcPtg?_%<<fI_^xMSEIsCsM~e~er~Bm$Og7?1DW
zjVtrHLt65Xu23HcUdv3svb;buejST0{MX@BWOnJ7X1!&?>+gDjh)y&4dORPCw3~tQ
z6?JGiDTo!v`Bot1iXwz~lz}tMdEq`V-I^cJ2P-KY`uj-@mrNX_er3tALPAuxg4<$U
z3-223O5zQ)TtN_K==UmP*A+d{@MGCYvv9TZq9BD}zt$f*S0gB3Ijj650~*u0>kEVi
zZZ`J1hD9d{Ar%t5S>&W5u?vDOk3HFzL(Y^!NZ-1T`ufEcaz?U)i2NqC*J@hDqV=7R
zDKCbSEQM7NH$N?@pqpKvAmBUJ51#yNLgKPRUxM9a#{S&a1%lTKrk{XJ{gKpV;pu?^
z{i4^ODUB>v_D48Wv;O==3z+3&rYYfulJh9jZqAX3+47Zb{lY59NbVf2Q58S3bKK;+
z0Q#84z|{--U9m{`wrmCDcKtNZKLY537PJ|Rm9f5UOR#pW!UG;v#p@4#hloC9ws{S*
z?sE$WJ72;nu7bEQs*}%Yo|3509wMO8f}F}Hadj*be#Fe0L!?Z^E-+?7Lggs;FxpiT
zE(^nw&di^QN81$&Wy$WcBZoSxscCAJUamZz4UfOf_(?n(R{7IQx{MwLG5Okf8-nj5
z0fnz*m1cOOg#PYQh&AvoXn6;Dgt}vx-=Ubd5R2ySt~QktuCz;fj=cWRH;7=Czi}r^
zd4?+~z%xk1;lbn(ilawCES5&SKe!Y`zhGdzMb$sVw8XXO>`WGWwRr=fn+Z^_%;jdh
z5YRIq+3&=gwoqfOKX>tLF4vz1Fw3w{<_Bu}wqNVS`O$PdE^0`T6vV|53`;6?Y2W=V
z0-K(D0StohZ?RQjL$A?1aF=mD=QTA=7|<*323SGpSe0K5B&%=Uv}SpqdBs9;KZ1(`
zUyoFxq#qk9y)t48ToYRrE@WmbE7=<UUL*y{o?koDUfXn8ji&Eg4Uk3t5gufgOXAU$
zj)0d_qp-u6*>Dxw{hK>GK`94Av-wC8@V@Ry_`zblh})Slg>NRy^;Km4KDBl4F4UF6
z<E@=BjT!~9GZ<B8j=$MkMw)WXHU<Sy6`7x+K~HP<(<>BGNLIzEPK@j<?PI2l2gjQ+
zqL5Am`0{RNs3KX7)o$hbz=iLW@O;<GSRz?o-xKZlwOzW!u9qhTaeE16Cnj%W==~(2
z@P19t_6+{-c%)sWs6NO-R2<&x0--AfppG2}kOmFn?4OefeM!&LD^*x<Aq!#IGQx{5
z()@T#^!52Dal&5G_UW?*C4ZQRK57G>_|;e>JhzZcJMAk^3gVP4XYEyZXVtiV_12&k
zziDCc&GF`jpJLgvqMK2D{?OMz_`JnSyG)r#`?h^D5AP#1dqL}@GC|XX(5FhK$%1$a
zh^7vKcGEOKPUF;nF^#~}tTIC#5I#dP@mJ!J_M(HqS*?kKe?KA>L=7<IW<GV-)5JK_
zLLhJGnrP_le7rXs!R4dw9REd=JV-oh;hvF-;b6iy<67d*oUCz8O`iI}ij$<k$&h@a
z5ImQGxnQaXrO*!5S4;y#OFLI8z;35&We0&;iU|gn%bYnKbS`}stW9koc)kWwms-=e
z29>FnbzEHN1d*8pG2~;$f3kFqSJpV@hr#sAq=uKrG4&5ZOk&b&K&WP&Yly@YK+Xiy
zY!FXp&<x@ONqY)552_<(er%3s@IA%G+Rb**N3?<{r1#g7<#!OlGL(~9{#<M>yQRB3
zGirRcf^|~=1b^^y52^cz1>iOVOxQ=vJ3*v_QK9Z#%&4HD`<Indq!Tu6w^e}GBok-E
zR(C2#%>oqn?vbUbAnuJ1N=Y{A<;p^|*zB0Vz&=U1v9|>5^9r8RlPtf72{#sCHRZhv
z2L2R}gst5C^TUV3wN#o4;<BhtY-~A2vQQ|E^%kVxV#yc9yW0QPO%_y;*Tjib%O0M?
z5O2qyd|c5t_4qoeAvh~ZSPe2xPv$0%d8E}3=4)cn_J{M>N8U&u6$+xH=W7gpn3;Y^
zmKmaWy@a;3C-S%%HZ0XIUR<8+>#G9BRkBQ0m9bvMtW|+<q6B+2pkAh&5pf~`DpBXK
z`BrC%Z^eTP@369*`4)ywBMndH1M4bpD=I};xqFg&@$X|`P5FR+!^@-5ZJ(T5Ch{w1
z7pc#iH?O>Z@~rO?iCc`xroP8&XO9u{gF4enk0v)sDaJAMnIyz<kTjc#XM<^qx(o}T
znwe`rR1Lr`()wP>d`nNX{Wlgv6!ndv+nAx;VoEXfTPjThNTF5oYs}b4L>riS6G80I
zS>K7W<jbXob(PJsI%>WkN+`1zv`((@$j1RXI~yV8t1jvK!tT{8*O<{)X{5_N6FUhw
zCtrM|>8g!E#my)uPW6{c)4=NAgh7^glL#>e;>7Z09pV+yCtr@Q?bwxPzKTlzs8SFm
z>H5H;R)((3sHI@xS*>Y_OV@XHnueUtU2x%Xx<|Rsm_g^*T1QF=RBDE|0osZb9#tx3
zgTlSq3Ra=M*hSzSNb+vdc-Nq3;`UnX+&kLLv$mvRqtYl*5QnCS5rXh741F9LeqcjB
zd9OmiZ@VMmYfU>Mz~>KLW|9l!pbI}K<L^EOzf8c(1bRsUbteb-<=3k8^*KE(=3NS<
z+rcPN5O)QbejoW25md^6qRW7RTjG(hauGKysq}PJQ?CWdD@bLPQt8;#j?er$K<i0x
z?;v=iKB#SRhJ@&@tesMGcWca^o1!m{>{)iF#SoM!)+(POcPKibLi|8%Rl8DFOMfu+
zM$%Vau2m%x`jkC;^tEf(s{2BogM=N7ZIm}XsuX18ZshZa=7XRxnPwJX9@QdNDc5#^
zu@eM!x!uLUc4B-l77Z(9b*B`2+jVCYCR7SHz@jKf;f7~DQ(k||zY+-r8eM5!+g1%_
z`c$sy>jfyLvmO&Hx^*4BsKhRo7ywg0v!`F`+xs`IS<^rE1+XR8qEsr1g19zP7c@=1
zkMvEReYYSe7@h;M7zcP9LO)mF&gxI$+wN0n?4<r*o&N=?H-KK9@R|f~9Nf2KL#d@{
zb4}hyA)(Q&ATCW<DmFY>whTlI(q_<&3jSX*-Xw@ON$`HjVy{T@{-g){$`WE<_u_N+
zTD^q3#NHU0B1)jd6~u*4L=lBM*7fL@K#42Juz<%DW%Mt#(K&)qq9CJFxJBc7cvi=Z
zzmBKi2v?A?FOTCDa+DJ|!WHBwpWP#U_yySij$#EVfOL=a1$q>W?<iJ~qhNN&hUi!V
zV+!I}gkuCsTLR8b3S$aV+Os>xU6Ca)rXWS0fU)jNTLNPWQrhz~#$DbdVDIQPrXYEn
zfKfo$-WnMN1IZtYV+xW#*^W^@0wge|AV<I?jtwDy5-6I2jD6knH>qQk-IIWO3Szb5
zt$ufJOrwa>m{3Z6vfNXULX325JrzRAV|^SX0s9Ivwm8if&X|0TNX4?RAV=iz#|Bjl
s35=$_Wb`Y@Xp(j@R^wQojwJB^0Tk+&Co|G<j{pDw07*qoM6N<$f*d@BqW}N^

literal 0
HcmV?d00001

diff --git a/docs/assets/project-logo.png b/docs/assets/project-logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..3075f9a77a48da8781efd27fbc89aa5b119019c2
GIT binary patch
literal 3770
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
OY=EherC}Y^J>frv4BLkQ

literal 0
HcmV?d00001

diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..770e9da
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,178 @@
+# Introduction
+
+Kubernetes [external chaincode builder](https://hyperledger-fabric.readthedocs.io/en/latest/cc_launcher.html) for Hyperledger Fabric.
+
+With the k8s builder, the Fabric administrator is responsible for [preparing a chaincode image](#chaincode-docker-image), publishing to a container registry, and [preparing a chaincode package](#chaincode-package) with coordinates of the contract's immutable image digest.
+When Fabric detects the installation of a `type=k8s` contract, the builder assumes full ownership of the lifecycle of pods, containers, and network linkages necessary to communicate securely with the peer.
+
+
+Advantages:
+
+🚀 Chaincode runs _immediately_ on channel commit.
+
+✨ Avoids the complexity and administrative burdens associated with Chaincode-as-a-Service.
+
+🔥 Pre-published chaincode images avoid code-compilation errors at deployment time.
+
+🏗️ Pre-published chaincode images encourage modern, industry accepted CI/CD best practices.
+
+🛡️ Pre-published chaincode images remove any and all dependencies on a root-level _docker daemon_.
+
+🕵️ Pre-published chaincode images provide traceability and change management features (e.g. Git commit hash as image tag)
+
+The aim is for the builder to work as closely as possible with the existing [Fabric chaincode lifecycle](https://hyperledger-fabric.readthedocs.io/en/latest/chaincode_lifecycle.html), making sensible compromises for deploying chaincode on Kubernetes within those constraints.
+(The assumption being that there are more people with Kubernetes skills than are familiar with the inner workings of Fabric!)
+
+For example:
+
+- The contents of the chaincode package must uniquely identify the chaincode functions executed on the ledger. 
+
+  In the case of the k8s builder the chaincode source code is not actually inside the package.  In order not to break the Fabric chaincode lifecycle, the chaincode image must be specified using an immutable `@digest`, not a `:label` which can be altered post commit.
+  
+  See [Pull an image by digest (immutable identifier)](https://docs.docker.com/engine/reference/commandline/pull/#pull-an-image-by-digest-immutable-identifier) for more details.
+
+
+- The Fabric peer manages the chaincode process, not Kubernetes.
+
+  Running the chaincode in server mode, i.e. allowing the peer to initiate the gRPC connection, would make it possible to leave Kubernetes to manage the chaincode process by creating a chaincode deployment.
+
+  Unfortunately due to limitations in Fabric's builder and launcher implementation, that is not possible and the peer expects to control the chaincode process.
+
+
+**Status:** the k8s builder is [close to a version 1 release](https://github.com/hyperledger-labs/fabric-builder-k8s/milestone/1) and has been tested in a number of Kubernetes environments, deployment platforms, and provides semantic-revision aware [release tags](https://github.com/hyperledger-labs/fabric-builder-k8s/tags) for the external builder binaries.
+The current status should be considered as STABLE and any bugs or enhancements delivered as GitHub Issues in conjunction with community PRs.
+
+## Usage
+
+The k8s builder can be run in cluster using the `KUBERNETES_SERVICE_HOST` and `KUBERNETES_SERVICE_PORT` environment variables, or it can connect using a `KUBECONFIG_PATH` environment variable.
+
+The following optional environment variables can be used to configure the k8s builder:
+
+- `FABRIC_K8S_BUILDER_DEBUG` whether to enable additional logging
+- `FABRIC_K8S_BUILDER_NAMESPACE` specifies the namespace to deploy chaincode to
+- `FABRIC_K8S_BUILDER_SERVICE_ACCOUNT` specifies the service account for the chaincode pod
+
+A `CORE_PEER_ID` environment variable is also currently required.
+
+External builders are configured in the `core.yaml` file, for example:
+
+```
+  externalBuilders:
+    - name: k8s_builder
+      path: /opt/hyperledger/k8s_builder
+      propagateEnvironment:
+        - CORE_PEER_ID
+        - FABRIC_K8S_BUILDER_DEBUG
+        - FABRIC_K8S_BUILDER_NAMESPACE
+        - FABRIC_K8S_BUILDER_SERVICE_ACCOUNT
+        - KUBERNETES_SERVICE_HOST
+        - KUBERNETES_SERVICE_PORT
+```
+
+See [External Builders and Launchers](https://hyperledger-fabric.readthedocs.io/en/latest/cc_launcher.html) for details of Hyperledger Fabric builders.
+
+As well as configuring Fabric to use the k8s builder, you will need to [configure Kubernetes](docs/KUBERNETES_CONFIG.md) to allow the builder to start chaincode pods successfully.
+
+There are addition docs with more detailed usage instructions for specific Fabric network deployments:
+
+- [Kubernetes Test Network](../tutorials/test-network-k8s.md)
+- [Nano Test Network](../tutorials/test-network-nano.md)
+- [Fabric Operator](../tutorials/fabric-operator.md)
+- [HLF Operator](../tutorials/hlf-operator.md)
+
+## Chaincode Docker image
+
+Unlike the traditional chaincode language support for Go, Java, and Node.js, the k8s builder *does not* build a chaincode Docker image using Docker-in-Docker.
+Instead, a chaincode Docker image must be built and published before it can be used with the k8s builder.
+
+The chaincode will have access to the following environment variables:
+
+- CORE_CHAINCODE_ID_NAME
+- CORE_PEER_ADDRESS
+- CORE_PEER_TLS_ENABLED
+- CORE_PEER_TLS_ROOTCERT_FILE
+- CORE_TLS_CLIENT_KEY_PATH
+- CORE_TLS_CLIENT_CERT_PATH
+- CORE_TLS_CLIENT_KEY_FILE
+- CORE_TLS_CLIENT_CERT_FILE
+- CORE_PEER_LOCALMSPID
+
+See the [sample contracts for Go, Java, and Node.js](samples/README.md) for basic docker images which will work with the k8s builder.
+
+## Chaincode package
+
+The k8s chaincode package file, which is installed by the `peer lifecycle chaincode install` command, must contain the Docker image name and digest of the chaincode being deployed.
+
+[Fabric chaincode packages](https://hyperledger-fabric.readthedocs.io/en/latest/cc_launcher.html#chaincode-packages) are `.tgz` files which contain two files:
+
+- metadata.json - the chaincode label and type
+- code.tar.gz - source artifacts for the chaincode
+
+To create a k8s chaincode package file, start by creating an `image.json` file.
+For example,
+
+```shell
+cat << IMAGEJSON-EOF > image.json
+{
+  "name": "ghcr.io/hyperledger-labs/go-contract",
+  "digest": "sha256:802c336235cc1e7347e2da36c73fa2e4b6437cfc6f52872674d1e23f23bba63b"
+}
+IMAGEJSON-EOF
+```
+
+Note: the k8s chaincode package file uses digests because these are immutable, unlike tags.
+The docker inspect command can be used to find the digest if required.
+
+```
+docker pull ghcr.io/hyperledger-labs/go-contract:v0.7.2
+docker inspect --format='{{index .RepoDigests 0}}' ghcr.io/hyperledger-labs/go-contract:v0.7.2 | cut -d'@' -f2
+```
+
+Create a `code.tar.gz` archive containing the `image.json` file.
+
+```shell
+tar -czf code.tar.gz image.json
+```
+
+Create a `metadata.json` file for the chaincode package.
+For example,
+
+```shell
+cat << METADATAJSON-EOF > metadata.json
+{
+    "type": "k8s",
+    "label": "go-contract"
+}
+METADATAJSON-EOF
+```
+
+Create the final chaincode package archive.
+
+```shell
+tar -czf go-contract.tgz metadata.json code.tar.gz
+```
+
+Ideally the chaincode package should be created in the same CI/CD pipeline which builds the docker image.
+There is an example [package-k8s-chaincode-action](https://github.com/hyperledgendary/package-k8s-chaincode-action) GitHub Action which can create the required k8s chaincode package.
+
+The GitHub Action repository includes a basic shell script which can also be used for automating the process above outside GitHub workflows.
+For example, to create a basic k8s chaincode package using the `pkgk8scc.sh` helper script.
+
+```shell
+curl -fsSL https://raw.githubusercontent.com/hyperledgendary/package-k8s-chaincode-action/main/pkgk8scc.sh -o pkgk8scc.sh && chmod u+x pkgk8scc.sh
+./pkgk8scc.sh -l go-contract -n ghcr.io/hyperledger-labs/go-contract -d sha256:802c336235cc1e7347e2da36c73fa2e4b6437cfc6f52872674d1e23f23bba63b
+```
+
+## Chaincode deploy
+
+Deploy the chaincode package as usual, starting by installing the k8s chaincode package.
+
+```shell
+peer lifecycle chaincode install go-contract.tgz
+```
+
+You can also use the `peer` command to get the chaincode package ID.
+
+```shell
+export PACKAGE_ID=$(peer lifecycle chaincode calculatepackageid go-contract.tgz) && echo $PACKAGE_ID
+```
diff --git a/docs/FABRIC_OPERATOR.md b/docs/tutorials/fabric-operator.md
similarity index 100%
rename from docs/FABRIC_OPERATOR.md
rename to docs/tutorials/fabric-operator.md
diff --git a/docs/HLF_OPERATOR.md b/docs/tutorials/hlf-operator.md
similarity index 100%
rename from docs/HLF_OPERATOR.md
rename to docs/tutorials/hlf-operator.md
diff --git a/docs/TEST_NETWORK_K8S.md b/docs/tutorials/test-network-k8s.md
similarity index 100%
rename from docs/TEST_NETWORK_K8S.md
rename to docs/tutorials/test-network-k8s.md
diff --git a/docs/TEST_NETWORK_NANO.md b/docs/tutorials/test-network-nano.md
similarity index 100%
rename from docs/TEST_NETWORK_NANO.md
rename to docs/tutorials/test-network-nano.md
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 0000000..4cd0831
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,86 @@
+site_name: Hyperledger Fabric Chaincode Builder for Kubernetes
+repo_name: hyperledger-labs/fabric-builder-k8s
+repo_url: https://github.com/hyperledger-labs/fabric-builder-k8s
+theme:
+  name: material
+  custom_dir: overrides
+  logo: assets/project-logo.png
+  favicon: assets/project-icon.png
+  icon:
+    repo: fontawesome/brands/github
+  palette:
+    # Palette toggle for light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    # Palette toggle for dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  features:
+  - content.code.copy
+  - navigation.expand
+  - navigation.footer
+  - navigation.instant
+  - navigation.tabs
+  - navigation.tabs.sticky
+  - navigation.top
+  - navigation.tracking
+  - toc.follow
+  - toc.integrate
+markdown_extensions:
+  - abbr
+  - admonition
+  - attr_list
+  - def_list
+  - footnotes
+  - md_in_html
+  - toc:
+      permalink: true
+      toc_depth: 3
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.betterem:
+      smart_enable: all
+  - pymdownx.caret
+  - pymdownx.details
+  - pymdownx.emoji:
+      emoji_generator: !!python/name:materialx.emoji.to_svg
+      emoji_index: !!python/name:materialx.emoji.twemoji
+  - pymdownx.highlight:
+      anchor_linenums: true
+  - pymdownx.inlinehilite
+  - pymdownx.keys
+  - pymdownx.magiclink:
+      repo_url_shorthand: true
+      user: squidfunk
+      repo: mkdocs-material
+  - pymdownx.mark
+  - pymdownx.smartsymbols
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - pymdownx.tilde
+plugins:
+  - search
+  - mike
+extra:
+  version:
+    provider: mike
+nav:
+  - Introduction: index.md
+  - Tutorials:
+    - Kubernetes Test Network: tutorials/test-network-k8s.md
+    - Nano Test Network: tutorials/test-network-nano.md
+    - Fabric Operator: tutorials/fabric-operator.md
+    - HLF Operator: tutorials/hlf-operator.md
diff --git a/overrides/main.html b/overrides/main.html
new file mode 100644
index 0000000..8d9f505
--- /dev/null
+++ b/overrides/main.html
@@ -0,0 +1,8 @@
+{% extends "base.html" %}
+
+{% block outdated %}
+  You're not viewing the latest version.
+  <a href="{{ '../' ~ base_url }}"> 
+    <strong>Click here to go to latest.</strong>
+  </a>
+{% endblock %}
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..04ebb9b
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,2 @@
+mkdocs-material
+mike