Fix documentation, add linter

[turbolent]

Description

• Fix all the broken links
• Add a linter that checks the links and integrate it into CI
• Improve operator docs

---

• Targeted PR against master branch
• Linked to Github issue with discussion and accepted design OR link to spec that describes this work
• Code follows the standards mentioned here
• Updated relevant documentation
• Re-reviewed Files changed in the Github PR explorer
• Added appropriate labels

[github-actions]

Cadence Benchstat comparison

This branch with compared with the base branch onflow:master commit 0e19bb9
The command for i in {1..N}; do go test ./... -run=XXX -bench=. -benchmem -shuffle=on; done was used.
Bench tests were run a total of 7 times on each branch.

Collapsed results for better readability

	old.txt	new.txt
	time/op		delta
CheckContractInterfaceFungibleTokenConformance-2	136µs ± 1%	135µs ± 0%	−1.09%	(p=0.002 n=7+6)
ContractInterfaceFungibleToken-2	42.3µs ± 1%	41.9µs ± 1%	−0.89%	(p=0.007 n=7+7)
InterpretRecursionFib-2	3.70ms ± 1%	3.68ms ± 1%	−0.56%	(p=0.041 n=6+6)
NewInterpreter/new_interpreter-2	1.14µs ± 1%	1.13µs ± 1%	−1.15%	(p=0.009 n=6+6)
NewInterpreter/new_sub-interpreter-2	2.49µs ± 1%	2.48µs ± 1%	~	(p=0.367 n=7+7)
ParseArray-2	8.37ms ± 1%	8.35ms ± 1%	~	(p=0.534 n=6+7)
ParseDeploy/byte_array-2	12.7ms ± 1%	12.6ms ± 1%	~	(p=0.181 n=6+7)
ParseDeploy/decode_hex-2	1.14ms ± 0%	1.14ms ± 1%	~	(p=0.132 n=6+6)
ParseFungibleToken/With_memory_metering-2	204µs ± 3%	204µs ± 1%	~	(p=0.731 n=7+6)
ParseFungibleToken/Without_memory_metering-2	155µs ± 0%	155µs ± 1%	~	(p=0.534 n=7+6)
ParseInfix-2	7.70µs ± 0%	7.64µs ± 1%	~	(p=0.055 n=6+7)
QualifiedIdentifierCreation/One_level-2	2.82ns ± 0%	2.42ns ± 0%	−14.23%	(p=0.001 n=6+7)
QualifiedIdentifierCreation/Three_levels-2	121ns ± 1%	121ns ± 1%	~	(p=0.189 n=7+6)
RuntimeFungibleTokenTransfer-2	1.16ms ±20%	1.11ms ±18%	~	(p=0.620 n=7+7)
RuntimeResourceDictionaryValues-2	6.32ms ± 2%	6.05ms ± 1%	−4.26%	(p=0.001 n=7+6)
ValueIsSubtypeOfSemaType-2	79.2ns ± 1%	79.4ns ± 2%	~	(p=1.000 n=6+7)
	alloc/op		delta
CheckContractInterfaceFungibleTokenConformance-2	67.0kB ± 0%	67.0kB ± 0%	~	(p=0.462 n=7+7)
ContractInterfaceFungibleToken-2	26.8kB ± 0%	26.8kB ± 0%	~	(all equal)
InterpretRecursionFib-2	1.51MB ± 0%	1.51MB ± 0%	~	(p=0.303 n=7+5)
NewInterpreter/new_interpreter-2	928B ± 0%	928B ± 0%	~	(all equal)
NewInterpreter/new_sub-interpreter-2	1.46kB ± 0%	1.46kB ± 0%	~	(all equal)
ParseArray-2	2.84MB ± 0%	2.81MB ± 2%	−1.18%	(p=0.045 n=5+7)
ParseDeploy/byte_array-2	4.44MB ± 2%	4.39MB ± 3%	~	(p=0.272 n=7+7)
ParseDeploy/decode_hex-2	214kB ± 0%	214kB ± 0%	~	(p=0.729 n=7+7)
ParseFungibleToken/With_memory_metering-2	36.3kB ± 0%	36.3kB ± 0%	~	(p=0.396 n=7+7)
ParseFungibleToken/Without_memory_metering-2	36.3kB ± 0%	36.3kB ± 0%	~	(p=0.495 n=7+5)
ParseInfix-2	2.17kB ± 0%	2.17kB ± 0%	+0.07%	(p=0.003 n=5+7)
QualifiedIdentifierCreation/One_level-2	0.00B	0.00B	~	(all equal)
QualifiedIdentifierCreation/Three_levels-2	64.0B ± 0%	64.0B ± 0%	~	(all equal)
RuntimeFungibleTokenTransfer-2	232kB ± 0%	232kB ± 0%	~	(p=1.000 n=7+7)
RuntimeResourceDictionaryValues-2	2.25MB ± 0%	2.25MB ± 0%	~	(p=0.456 n=7+7)
ValueIsSubtypeOfSemaType-2	48.0B ± 0%	48.0B ± 0%	~	(all equal)
	allocs/op		delta
CheckContractInterfaceFungibleTokenConformance-2	1.08k ± 0%	1.08k ± 0%	~	(all equal)
ContractInterfaceFungibleToken-2	461 ± 0%	461 ± 0%	~	(all equal)
InterpretRecursionFib-2	33.5k ± 0%	33.5k ± 0%	~	(all equal)
NewInterpreter/new_interpreter-2	13.0 ± 0%	13.0 ± 0%	~	(all equal)
NewInterpreter/new_sub-interpreter-2	42.0 ± 0%	42.0 ± 0%	~	(all equal)
ParseArray-2	70.0k ± 0%	70.0k ± 0%	~	(p=0.318 n=7+5)
ParseDeploy/byte_array-2	105k ± 0%	105k ± 0%	~	(p=0.091 n=7+5)
ParseDeploy/decode_hex-2	77.0 ± 0%	77.0 ± 0%	~	(all equal)
ParseFungibleToken/With_memory_metering-2	1.06k ± 0%	1.06k ± 0%	~	(all equal)
ParseFungibleToken/Without_memory_metering-2	1.06k ± 0%	1.06k ± 0%	~	(all equal)
ParseInfix-2	66.0 ± 0%	66.0 ± 0%	~	(all equal)
QualifiedIdentifierCreation/One_level-2	0.00	0.00	~	(all equal)
QualifiedIdentifierCreation/Three_levels-2	2.00 ± 0%	2.00 ± 0%	~	(all equal)
RuntimeFungibleTokenTransfer-2	4.19k ± 0%	4.19k ± 0%	~	(p=0.592 n=7+7)
RuntimeResourceDictionaryValues-2	37.5k ± 0%	37.5k ± 0%	~	(p=0.710 n=7+7)
ValueIsSubtypeOfSemaType-2	1.00 ± 0%	1.00 ± 0%	~	(all equal)

[codecov]

Codecov Report

Merging #1785 (868a5ef) into master (0e19bb9) will decrease coverage by 0.00%.
The diff coverage is n/a.

❗ Current head 868a5ef differs from pull request most recent head 28c4fde. Consider uploading reports for the commit 28c4fde to get more accurate results

@@            Coverage Diff             @@
##           master    #1785      +/-   ##
==========================================
- Coverage   77.38%   77.37%   -0.01%     
==========================================
  Files         306      306              
  Lines       62698    62698              
==========================================
- Hits        48517    48515       -2     
- Misses      12560    12562       +2     
  Partials     1621     1621              

Flag	Coverage Δ
unittests	77.37% <ø> (-0.01%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
runtime/interpreter/storage.go	69.04% <0.00%> (-1.59%)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 0e19bb9...28c4fde. Read the comment docs.

[joshuahannan]

Thanks for fixing all these!