Fix broken docstrings in bindings and minor API docs updates #4030

Job	Run time
Check tket library version	13s
Build and test (tket)	0s
Check documentation build	0s
Build and test (tket)	0s
Check C++ code formatting	0s
Build and test pytket (ubuntu)	12m 35s
Build and test tket (macos-arm64)	0s
Build and test (tket)	1s
Build and test (tket) (ubuntu-22.04)	1s
Build and test (tket) (macos-12)	2s
Build and test (tket) (windows-2022)	2s
Build and test pytket (macos-arm64)	2m 49s
Build and test pytket (macos)	12m 18s
Build and test pytket (windows)	17m 20s
Check pytket line and branch coverage	5s
Publish pytket coverage	0s
	45m 26s

Provide feedback