docs: improve LSP8 Natspec comments + add auto-generate docs #2084

Job	Run time
build	3m 50s
test-suites (up)	44s
test-suites (upinit)	1m 4s
test-suites (lsp1)	2m 6s
test-suites (lsp2)	33s
test-suites (lsp4)	57s
test-suites (lsp6)	2m 37s
test-suites (lsp6init)	3m 5s
test-suites (lsp7)	1m 29s
test-suites (lsp7init)	2m 13s
test-suites (lsp8)	1m 31s
test-suites (lsp8init)	2m 39s
test-suites (lsp9)	58s
test-suites (lsp9init)	1m 3s
test-suites (lsp11)	51s
test-suites (lsp11init)	49s
test-suites (lsp17)	26s
test-suites (lsp20)	2m 2s
test-suites (lsp20init)	4m 40s
test-suites (lsp23)	26s
test-suites (universalfactory)	29s
test-suites (reentrancy)	3m 19s
test-suites (reentrancyinit)	5m 34s
test-suites (mocks)	30s
	43m 55s

Provide feedback