Short version
When a language includes compilation, should the examples in Documentation be able to compile?
(Except - of course - examples with the purpose of showing illegal code.)
Background
I was reading a topic in Documentation and came across an example containing code that was unable to compile. So I decided to do an edit. The edit was rather small and didn't change the overall intend of the topic. It only fixed the errors that prevented successful compilation.
My edit was rejected (after being accepted by 3 and rejected by 3). The user profiles of the 3 rejecting users, don't show much/any activity in the specific language.
What to do?
My first reaction was that I should find out how I could dispute their decision and send the proposed edit for a second review.
But then I got in doubt: Maybe it is perfectly fine that examples can't compile. Maybe it is more important that an example illustrates a topic correct and less important that the code can compile.
So I see two options
a) Send the proposed edit for a second review (somehow)
b) Forget about it (as it isn't a quality improvement to make the code able to compile)
To make up my mind I like to know whether it is intended that Documentation examples shall be able to compile?
public static class Program { public static void Main() { … } }
) or complete instructions on how to set up the build process; that would only distract from what the example is trying to show.