Can we add an example of that usage to the status object with a note not to follow the "return this in case of error" pattern that you might see elsewhere in the code? It might even be worth a bit of refactoring to get rid of the old pattern or people will still keep finding it and copying it.
{{done}} [0]
[0]: https://gerrit.wikimedia.org/r/#q,Ia98543caaa829cad443abf0f0f5038b3de943ef8,...