docs: Suggestions: network model

[swo]

Builds off #847

[ghost]

Benchmark Results

Hyperfine

Command	Mean [ms]	Min [ms]	Max [ms]	Relative
large_sir::baseline	3.0 ± 0.0	3.0	3.2	1.00
large_sir::entities	11.4 ± 0.1	11.2	11.9	3.75 ± 0.06

Criterion

Regressions (slower)

Group	Bench	Param	Change	CI Lower	CI Upper
sample_entity	sample_entity_single_property_unindexed	10000	36.830%	31.889%	42.048%
indexing	query_people_single_indexed_property_entities		15.217%	15.112%	15.324%
counts	single_property_indexed_entities		8.017%	7.499%	8.590%
algorithm_benches	algorithm_sampling_multiple_known_length		7.184%	6.711%	7.672%
algorithm_benches	algorithm_sampling_multiple_l_reservoir		4.100%	3.461%	4.754%
large_dataset	bench_query_population_indexed_property_entities		3.055%	2.133%	3.911%
sampling	sampling_multiple_known_length_entities		2.214%	1.819%	2.779%
indexing	query_people_multiple_individually_indexed_properties_entities		2.079%	1.959%	2.182%
large_dataset	bench_match_entity		1.725%	1.149%	2.417%

Improvements (faster)

Group	Bench	Param	Change	CI Lower	CI Upper
indexing	with_query_results_single_indexed_property_entities		-37.472%	-37.678%	-37.189%
indexing	with_query_results_multiple_individually_indexed_properties_enti		-28.447%	-28.559%	-28.325%
indexing	with_query_results_indexed_multi-property_entities		-15.290%	-16.665%	-13.870%
sample_entity	sample_entity_single_property_unindexed	1000	-9.233%	-11.382%	-6.933%
sample_entity	sample_entity_whole_population	10000	-8.986%	-12.556%	-5.506%
large_dataset	bench_query_population_derived_property_entities		-6.417%	-7.104%	-5.668%
indexing	query_people_indexed_multi-property_entities		-4.032%	-4.269%	-3.679%
indexing	query_people_count_single_indexed_property_entities		-3.440%	-3.735%	-3.150%

Unchanged / inconclusive (CI crosses 0%)

Group	Bench	Param	Change	CI Lower	CI Upper
examples	example-basic-infection		5.779%	0.898%	17.895%
sample_entity	sample_entity_whole_population	100000	-4.326%	-8.656%	0.801%
sampling	sampling_single_l_reservoir_entities		-1.218%	-2.021%	-0.584%
sampling	sampling_single_unindexed_concrete_plus_derived_entities		-1.073%	-1.199%	-0.952%
sample_entity	sample_entity_multi_property_indexed	100000	-0.997%	-1.507%	-0.478%
sample_entity	sample_entity_single_property_indexed	100000	-0.814%	-1.238%	-0.461%
sample_entity	sample_entity_single_property_unindexed	100000	0.711%	0.250%	1.307%
indexing	query_people_count_indexed_multi-property_entities		0.707%	0.198%	1.230%
sample_entity	sample_entity_multi_property_indexed	1000	0.693%	0.363%	1.159%
sample_entity	sample_entity_single_property_indexed	10000	-0.658%	-1.200%	-0.263%
sample_entity	sample_entity_single_property_indexed	1000	-0.617%	-1.209%	-0.180%
large_dataset	bench_query_population_property_entities		-0.607%	-1.406%	-0.047%
counts	index_after_adding_entities		0.580%	0.452%	0.706%
sampling	count_and_sampling_single_unindexed_concrete_plus_derived_entiti		0.554%	0.513%	0.597%
large_dataset	bench_filter_indexed_entity		0.465%	-7.319%	9.030%
large_dataset	bench_filter_unindexed_entity		0.452%	-2.621%	3.856%
counts	single_property_unindexed_entities		-0.407%	-0.795%	-0.092%
sample_entity	sample_entity_whole_population	1000	0.405%	-5.786%	7.078%
sampling	sampling_single_unindexed_entities		-0.385%	-0.490%	-0.276%
indexing	query_people_count_multiple_individually_indexed_properties_enti		-0.316%	-0.378%	-0.254%
algorithm_benches	algorithm_sampling_single_l_reservoir		-0.298%	-0.837%	0.236%
large_dataset	bench_query_population_multi_indexed_entities		-0.279%	-0.971%	0.315%
counts	reindex_after_adding_more_entities		0.206%	0.044%	0.361%
sampling	count_and_sampling_single_known_length_entities		-0.201%	-0.618%	0.358%
sample_entity	sample_entity_multi_property_indexed	10000	0.146%	-0.546%	0.746%
sampling	sampling_multiple_l_reservoir_entities		-0.108%	-0.751%	0.495%
large_dataset	bench_query_population_multi_unindexed_entities		-0.107%	-0.688%	0.439%
sampling	sampling_single_known_length_entities		-0.090%	-0.623%	0.436%
examples	example-births-deaths		0.088%	-0.148%	0.321%
counts	multi_property_unindexed_entities		-0.079%	-0.616%	0.260%
algorithm_benches	algorithm_sampling_single_rand_reservoir		-0.053%	-0.231%	0.106%
sampling	sampling_multiple_unindexed_entities		0.039%	-0.095%	0.169%
counts	multi_property_indexed_entities		-0.032%	-0.230%	0.199%
counts	concrete_plus_derived_unindexed_entities		-0.026%	-0.321%	0.412%
algorithm_benches	algorithm_sampling_single_known_length		-0.005%	-0.845%	0.924%

[swo]

Suggestions incorporated into #847

cc @bbbruce