Fix and clarification in docs #1097

Job	Run time
Collect changes / collect-changes	9s
Python tests / lint-and-format-check	0s
status-check	4s
Python tests / unit-tests	0s
Python tests / types-check	0s
	13s

Provide feedback