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

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

Provide feedback