Again, Org manual, as published in "orgmode.org", is generated through
Texinfo, which treats "begin_src org" exactly as "begin_example". So,
switching to "begin_src org" will not give us Org fontification in HTML
output.
This is not about typing. When the markup is more visible than the
contents, it is visual clutter.
It is a matter of taste. I tested both when updating the manual, and
eventually settled for example blocks.
In any case, I have no strong opinion about it. I just lean towards
simplicity.
> While pasting that example, I realized, that you don't even need to
> specially made an Org snippet an src block just because you want to use it
> as a noweb ref in the manual. Making Org snippets, src blocks, always, just
> feels like the right thing.
I didn't understand this part.
Kaushal Modi