Indeed, during the explanations, it makes more sense to start with the state. Doc: rework the documentation of the Algo API.