Skip to content

Commit 3bd24ec

Browse files
authored
Docs cleanup (#1969)
cleanup docs
1 parent 9930660 commit 3bd24ec

File tree

17 files changed

+92
-444
lines changed

17 files changed

+92
-444
lines changed

book/book.toml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,10 @@ build-dir = "docs"
1212
default-theme = "ayu"
1313
additional-js = ["mermaid.min.js", "mermaid-init.js"]
1414

15+
[output.html.fold]
16+
enable = true
17+
level = 0
18+
1519
[preprocessor.alerts]
1620
[preprocessor.cmdrun]
1721

book/src/SUMMARY.md

Lines changed: 66 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -2,70 +2,59 @@
22

33
- [Overview](./overview.md)
44
- [Framework](./framework/overview.md)
5+
- [Basic Usage](./framework/getting_started.md)
56
- [Getting Started](./framework/getting_started.md)
67
- [Your First Test](./framework/first_test.md)
78
- [NodeSet Environment](./framework/nodeset_environment.md)
8-
- [NodeSet Environment (Import Keys)](./framework/nodeset_environment_import.md)
9-
- [NodeSet with Capabilities](./framework/nodeset_capabilities.md)
9+
- [NodeSet (Capabilities)](./framework/nodeset_capabilities.md)
1010
- [NodeSet (Local Docker builds)](./framework/nodeset_docker_rebuild.md)
11-
- [NodeSet Compat Environment](./framework/nodeset_compatibility.md)
11+
- [Advanced Usage](./framework/configuration.md)
12+
- [CLI](./framework/cli.md)
13+
- [Configuration](./framework/configuration.md)
14+
- [Debugging Tests](framework/components/debug.md)
1215
- [Creating your own components](./developing/developing_components.md)
16+
- [Exposing Components](framework/components/state.md)
1317
- [Asserting Logs](./developing/asserting_logs.md)
1418
- [Quick Contracts Deployment](./framework/quick_deployment.md)
1519
- [Verifying Contracts](./framework/verify.md)
16-
- [NodeSet with External Blockchain]()
17-
- [CLI](./framework/cli.md)
18-
- [Configuration](./framework/configuration.md)
20+
- [CL Node Keys Import](./framework/cl_node_keys_import.md)
1921
- [Test Configuration](./framework/test_configuration_overrides.md)
20-
- [Exposing Components](framework/components/state.md)
21-
- [Debugging Tests](framework/components/debug.md)
2222
- [Debugging K8s Chaos Tests](framework/chaos/debug-k8s.md)
2323
- [Components Cleanup](framework/components/cleanup.md)
2424
- [Components Caching](framework/components/caching.md)
2525
- [Components Resources](framework/components/resources.md)
2626
- [Containers Network Isolation](framework/components/network_isolation.md)
27-
- [Faking Services](framework/components/mocking.md)
27+
- [Fake Services](framework/components/mocking.md)
2828
- [Copying Files](framework/copying_files.md)
2929
- [External Environment](framework/components/external.md)
30-
- [Troubleshooting](framework/components/troubleshooting.md)
31-
- [Secrets]()
32-
- [Observability Stack](framework/observability/observability_stack.md)
33-
- [Metrics](framework/observability/metrics.md)
34-
- [Logs](framework/observability/logs.md)
35-
- [Profiling](framework/observability/profiling.md)
36-
- [PostgreSQL](framework/observability/postgresql.md)
37-
- [Traces]()
38-
- [Blockscout](framework/observability/blockscout.md)
39-
- [Components](framework/components/overview.md)
40-
- [Blockchains](framework/components/blockchains/overview.md)
41-
- [EVM](framework/components/blockchains/evm.md)
42-
- [Solana](framework/components/blockchains/solana.md)
43-
- [Aptos](framework/components/blockchains/aptos.md)
44-
- [Sui](framework/components/blockchains/sui.md)
45-
- [TRON](framework/components/blockchains/tron.md)
46-
- [ZKSync](framework/components/blockchains/zksync.md)
47-
- [Ton](framework/components/blockchains/ton.md)
48-
- [Optimism Stack]()
49-
- [Arbitrum Stack]()
50-
- [Chainlink](framework/components/chainlink.md)
51-
- [Node](framework/components/chainlink/node.md)
52-
- [NodeSet](framework/components/chainlink/nodeset.md)
53-
- [Storage](framework/components/storage.md)
54-
- [S3](framework/components/storage/s3.md)
55-
- [Chip Ingress Set](framework/components/chipingresset/chip_ingress.md)
56-
- [Clients]()
57-
- [Chainlink]()
58-
- [RPC]()
59-
- [Loki]()
30+
- [Observability Stack](framework/observability/observability_stack.md)
31+
- [Overview](framework/observability/observability_stack.md)
32+
- [Metrics](framework/observability/metrics.md)
33+
- [Logs](framework/observability/logs.md)
34+
- [Profiling](framework/observability/profiling.md)
35+
- [PostgreSQL](framework/observability/postgresql.md)
36+
- [BlockScout](framework/observability/blockscout.md)
37+
- [Components](framework/components/overview.md)
38+
- [Overview](framework/components/overview.md)
39+
- [Blockchains](framework/components/blockchains/overview.md)
40+
- [EVM](framework/components/blockchains/evm.md)
41+
- [Solana](framework/components/blockchains/solana.md)
42+
- [Aptos](framework/components/blockchains/aptos.md)
43+
- [Sui](framework/components/blockchains/sui.md)
44+
- [TRON](framework/components/blockchains/tron.md)
45+
- [ZKSync](framework/components/blockchains/zksync.md)
46+
- [Ton](framework/components/blockchains/ton.md)
47+
- [Storage](framework/components/storage.md)
48+
- [S3](framework/components/storage/s3.md)
49+
- [Chip Ingress Set](framework/components/chipingresset/chip_ingress.md)
50+
- [Troubleshooting](framework/components/troubleshooting.md)
6051
- [Mono Repository Tooling](./monorepo-tools.md)
6152
- [Testing Maturity Model](framework/testing.md)
62-
- [Smoke]()
63-
- [Performance]()
64-
- [Chaos](./framework/chaos/chaos.md)
53+
- [Chaos Testing](./framework/chaos/chaos.md)
6554
- [Fork Testing](./framework/fork.md)
6655
- [Fork Testing (Mutating Storage)](./framework/fork_storage.md)
6756
- [Libraries](./libraries.md)
68-
- [Seth](./libs/seth.md)
57+
- [Overview](./libraries.md)
6958
- [WASP](./libs/wasp/overview.md)
7059
- [Getting started](./libs/wasp/getting_started.md)
7160
- [First test (RPS test)](./libs/wasp/first_test.md)
@@ -112,45 +101,46 @@
112101
- [Reuse dashboard components](./libs/wasp/how-to/reuse_dashboard_components.md)
113102
- [Parallelize load](./libs/wasp/how-to/parallelise_load.md)
114103
- [Debug Loki errors](./libs/wasp/how-to/debug_loki_errors.md)
115-
- [Havoc](./libs/havoc.md)
116-
- [K8s Test Runner](k8s-test-runner/k8s-test-runner.md)
104+
- [Havoc](./libs/havoc.md)
105+
- [Seth](./libs/seth.md)
117106
- [Sentinel](./libs/sentinel.md)
118-
119107
---
120108

121-
- [Releasing modules](releasing_modules.md)
109+
- [Legacy](./legacy.md)
110+
- [Overview](./legacy.md)
111+
- [CTFv1](lib.md)
112+
- [Blockchain](lib/blockchain.md)
113+
- [Concurrency](lib/concurrency.md)
114+
- [Client](lib/client.md)
115+
- [Anvil]()
116+
- [AWS Secrets Manager](lib/client/aws_secrets_manager.md)
117+
- [Github](lib/client/github.md)
118+
- [Grafana](lib/client/grafana.md)
119+
- [Kafka](lib/client/kafka.md)
120+
- [Loki](lib/client/loki.md)
121+
- [MockServer](lib/client/mockserver.md)
122+
- [Postgres](lib/client/postgres.md)
123+
- [Prometheus](lib/client/prometheus.md)
124+
- [Kubernetes](lib/k8s_new/overview.md)
125+
- [Creating environments](lib/k8s_new/environments.md)
126+
- [Using remote runner](lib/k8s_new/remote_runner.md)
127+
- [Passing test secrets](lib/k8s_new/test_secrets.md)
128+
- [chain.link labels](lib/k8s/labels.md)
129+
- [Kubernetes (legacy docs)](lib/k8s/KUBERNETES.md)
130+
- [K8s Remote Run](lib/k8s/REMOTE_RUN.md)
131+
- [K8s Tutorial](lib/k8s/TUTORIAL.md)
132+
- [Config](lib/config/config.md)
133+
- [Docker](lib/docker/overview.md)
134+
- [Blockchain nodes](lib/docker/blockchain_nodes.md)
135+
- [Chainlink ecosystem](lib/docker/chainlink_ecosystem.md)
136+
- [Third party apps]()
137+
- [Test helpers](lib/docker/test_helpers.md)
138+
- [Logging](lib/logging.md)
139+
- [K8s Test Runner](k8s-test-runner/k8s-test-runner.md)
122140

123141
---
124142

125-
- [CTFv1 (Discouraged)](lib.md)
126-
- [Blockchain](lib/blockchain.md)
127-
- [Concurrency](lib/concurrency.md)
128-
- [Client](lib/client.md)
129-
- [Anvil]()
130-
- [AWS Secrets Manager](lib/client/aws_secrets_manager.md)
131-
- [Github](lib/client/github.md)
132-
- [Grafana](lib/client/grafana.md)
133-
- [Kafka](lib/client/kafka.md)
134-
- [Loki](lib/client/loki.md)
135-
- [MockServer](lib/client/mockserver.md)
136-
- [Postgres](lib/client/postgres.md)
137-
- [Prometheus](lib/client/prometheus.md)
138-
- [Kubernetes](lib/k8s_new/overview.md)
139-
- [Creating environments](lib/k8s_new/environments.md)
140-
- [Using remote runner](lib/k8s_new/remote_runner.md)
141-
- [Passing test secrets](lib/k8s_new/test_secrets.md)
142-
- [chain.link labels](lib/k8s/labels.md)
143-
- [Kubernetes (legacy docs)](lib/k8s/KUBERNETES.md)
144-
- [K8s Remote Run](lib/k8s/REMOTE_RUN.md)
145-
- [K8s Tutorial](lib/k8s/TUTORIAL.md)
146-
- [Config](lib/config/config.md)
147-
- [CRIB Connector](lib/crib.md)
148-
- [Docker](lib/docker/overview.md)
149-
- [Blockchain nodes](lib/docker/blockchain_nodes.md)
150-
- [Chainlink ecosystem](lib/docker/chainlink_ecosystem.md)
151-
- [Third party apps]()
152-
- [Test helpers](lib/docker/test_helpers.md)
153-
- [Logging](lib/logging.md)
143+
- [Releasing modules](releasing_modules.md)
154144

155145
---
156146

book/src/developing.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,4 @@ Here we describe good practices for developing components for our framework.
55
Rules for components are simple:
66
- Component should declare some `Input` and an optional `Output` (we use that so we can skip or cache any component results)
77
- Components should be isolated, they should not return anything except basic types like `int`, `string`, `maps` or `structs`
8-
- Component **must** have documentation under [Components](./framework/components/overview.md), here is an [example](./framework/components/chainlink/node.md)
8+
- Component **must** have documentation under [Components](./framework/components/overview.md), here is an [example](./framework/components/chainlink/nodeset.md)
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
1-
# NodeSet Environment (Import Keys)
1+
# CL Node Keys Import
22

33
If your tests are designed to run not just within a Docker environment but also with external infrastructure, and you want to reuse the test logic across different environments or securely store private keys, refer to the example below.
44

55
[Import Keys Example](https://github.com/smartcontractkit/chainlink-testing-framework/blob/main/framework/examples/myproject/smoke_import_keys_test.go)
6+

book/src/framework/components/chainlink/node.md

Lines changed: 0 additions & 112 deletions
This file was deleted.

0 commit comments

Comments
 (0)