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

Job	Run time
build	3m 12s
test-suites (up)	41s
test-suites (upinit)	1m 1s
test-suites (lsp1)	2m 15s
test-suites (lsp2)	25s
test-suites (lsp4)	32s
test-suites (lsp6)	2m 56s
test-suites (lsp6init)	4m 53s
test-suites (lsp7)	1m 1s
test-suites (lsp7init)	3m 16s
test-suites (lsp8)	2m 4s
test-suites (lsp8init)	4m 13s
test-suites (lsp9)	1m 0s
test-suites (lsp9init)	1m 4s
test-suites (lsp11)	35s
test-suites (lsp11init)	33s
test-suites (lsp17)	34s
test-suites (lsp20)	2m 50s
test-suites (lsp20init)	3m 4s
test-suites (lsp23)	24s
test-suites (universalfactory)	41s
test-suites (reentrancy)	2m 49s
test-suites (reentrancyinit)	3m 40s
test-suites (mocks)	27s
	44m 10s

Provide feedback