feat: new docs structure

[signorecello]

Please read contributing guidelines and remove this line.

[signorecello]

• feat: new docs structure #6195 : 2 dependent PRs (#6306 , #6350 ) 👈
• feat: replacing mentions to aztec-starter with codespace methods #6177 : 1 other dependent PR (#6180 )
• master

This stack of pull requests is managed by Graphite. Learn more about stacking.

Join @signorecello and the rest of your teammates on Graphite

[AztecBot]

Docs Preview

Hey there! 👋 You can check your preview at https://6644b2492a883e10b98f39ae--aztec-docs-dev.netlify.app

[critesjosh]

Wdyt about having these top level sections un-collapsed, so it's immediately clear what is in each section? I find myself immediately opening up all of the sections to see what's in there.

---

Do we need this top level "Aztec" dropdown? It's not very descriptive. Or maybe the Welcome page should become the page that you see when you click the "Aztec' dropdown, and that is the landing page.

[critesjosh]

Some page naming suggestions

[signorecello]

Wdyt about having these top level sections un-collapsed, so it's immediately clear what is in each section? I find myself immediately opening up all of the sections to see what's in there.

---

Do we need this top level "Aztec" dropdown? It's not very descriptive. Or maybe the Welcome page should become the page that you see when you click the "Aztec' dropdown, and that is the landing page.

Well coming un-collapsed would make them over 8 items which is anti-diataxis 😂 I see what you mean though, we could maybe split it into two sub-items and uncollapse, making sure we don't get near 8.

8 is too much. I shit you not, I do have some scientific evidence of that hahah. I stumbled upon a similar issue when I was a music student

Regarding top-down "Aztec" yes that's the "explanations" section which is even a weirder name. Suggestions welcome 🙏

[signorecello]

Damn it's doing that thing where it sees changes in other folders as new when they aren't. Here's my gitlens:

[AztecBot]

Benchmark results

No base data found for comparison.

Detailed results

All benchmarks are run on txs on the Benchmarking contract on the repository. Each tx consists of a batch call to create_note and increment_balance, which guarantees that each tx has a private call, a nested private call, a public call, and a nested public call, as well as an emitted private note, an unencrypted log, and public storage read and write.

This benchmark source data is available in JSON format on S3 here.

L2 block published to L1

Each column represents the number of txs on an L2 block published to L1.

Metric	8 txs	32 txs	64 txs
l1_rollup_calldata_size_in_bytes	740	740	740
l1_rollup_calldata_gas	6,692	6,692	6,692
l1_rollup_execution_gas	586,824	586,824	586,824
l2_block_processing_time_in_ms	1,350	4,983	9,860
l2_block_building_time_in_ms	22,769	88,821	176,729
l2_block_rollup_simulation_time_in_ms	22,627	88,335	175,794
l2_block_public_tx_process_time_in_ms	8,820	34,776	69,281

L2 chain processing

Each column represents the number of blocks on the L2 chain where each block has 16 txs.

Metric	5 blocks	10 blocks
node_history_sync_time_in_ms	16,395	29,562
node_database_size_in_bytes	22,954,064	39,485,520
pxe_database_size_in_bytes	29,868	59,425

Circuits stats

Stats on running time and I/O sizes collected for every circuit run across all benchmarks.

Circuit	circuit_simulation_time_in_ms	circuit_input_size_in_bytes	circuit_output_size_in_bytes	circuit_witness_generation_time_in_ms	circuit_proving_time_in_ms	circuit_proof_size_in_bytes
private-kernel-init	105	16,772	33,766	N/A	N/A	N/A
private-kernel-inner	303	57,607	33,766	N/A	N/A	N/A
private-kernel-ordering	685	213,464	48,421	N/A	N/A	N/A
base-parity	7.52	128	64.0	296	13,440	2,208
root-parity	49.5	27,064	64.0	207	183,859	2,720
base-rollup	654	111,094	925	7,931	164,784	3,104
root-rollup	64.0	11,454	789	189	16,898	3,424
public-kernel-app-logic	123	61,017	51,751	301	372	65,344
public-kernel-tail	440	166,458	7,691	463	423	10,112
public-kernel-setup	100	61,017	51,751	278	403	65,344
public-kernel-teardown	106	61,017	51,751	274	348	65,344
merge-rollup	6.39	2,696	925	158	3,608	3,104

Tree insertion stats

The duration to insert a fixed batch of leaves into each tree type.

Metric	1 leaves	16 leaves	64 leaves	128 leaves	512 leaves	1024 leaves	2048 leaves	4096 leaves	32 leaves
batch_insert_into_append_only_tree_16_depth_ms	11.2	18.2	N/A	N/A	N/A	N/A	N/A	N/A	N/A
batch_insert_into_append_only_tree_16_depth_hash_count	16.7	31.8	N/A	N/A	N/A	N/A	N/A	N/A	N/A
batch_insert_into_append_only_tree_16_depth_hash_ms	0.649	0.558	N/A	N/A	N/A	N/A	N/A	N/A	N/A
batch_insert_into_append_only_tree_32_depth_ms	N/A	N/A	51.4	82.4	258	533	964	1,913	N/A
batch_insert_into_append_only_tree_32_depth_hash_count	N/A	N/A	95.9	159	543	1,055	2,079	4,127	N/A
batch_insert_into_append_only_tree_32_depth_hash_ms	N/A	N/A	0.526	0.507	0.469	0.498	0.457	0.457	N/A
batch_insert_into_indexed_tree_20_depth_ms	N/A	N/A	61.3	122	373	781	1,458	2,866	N/A
batch_insert_into_indexed_tree_20_depth_hash_count	N/A	N/A	106	208	692	1,363	2,707	5,395	N/A
batch_insert_into_indexed_tree_20_depth_hash_ms	N/A	N/A	0.535	0.549	0.507	0.538	0.506	0.498	N/A
batch_insert_into_indexed_tree_40_depth_ms	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A	67.8
batch_insert_into_indexed_tree_40_depth_hash_count	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A	108
batch_insert_into_indexed_tree_40_depth_hash_ms	N/A	N/A	N/A	N/A	N/A	N/A	N/A	N/A	0.595

Miscellaneous

Transaction sizes based on how many contract classes are registered in the tx.

Metric	0 registered classes	1 registered classes
tx_size_in_bytes	51,016	1,046,607

Transaction size based on fee payment method

| Metric | |
| - | |

Transaction processing duration by data writes.

Metric	0 new note hashes	1 new note hashes	2 new note hashes
tx_pxe_processing_time_ms	2,146	1,896	5,102

Metric	0 public data writes	1 public data writes	2 public data writes	4 public data writes	8 public data writes
tx_sequencer_processing_time_ms	654	888	961	1,756	1,132