Fix broken docstrings in bindings and minor API docs updates (#920) #4033

Job	Run time
Check tket library version	39s
Build and test pytket (macos-arm64)	2m 23s
Build and test pytket (macos)	12m 29s
Build and test pytket (ubuntu)	12m 22s
Build and test pytket (windows)	21m 24s
Build and test tket (macos-arm64)	0s
Build and test (tket)	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 (tket)	0s
Check documentation build	0s
Check C++ code formatting	0s
Check pytket line and branch coverage	0s
Publish pytket coverage	36s
	49m 59s

Provide feedback