@Edent oh this is quite interesting. As this is one of my main frustration with the PHP docs at the moment.
I usually try to get people to not write any comments in the code block and have them show the output and add a paragraph if needed. As I don't really expect our translators to translate the examples (although some do which leads to inconsistencies)