feat(sol-macro): improve generated docs #1029

Job	Run time
clippy	40s
test stable --no-default-features	1m 36s
test stable	1m 29s
docs	35s
fmt	17s
test stable --all-features	1m 53s
test beta --no-default-features	1m 25s
test beta	1m 26s
feature-checks	4m 27s
test beta --all-features	1m 47s
miri --no-default-features	3m 18s
test nightly --no-default-features	1m 46s
miri	3m 21s
test nightly	1m 50s
miri --all-features	5m 38s
test nightly --all-features	2m 9s
wasm	47s
test 1.65 --no-default-features	1m 1s
test 1.65	1m 4s
	36m 29s

Provide feedback