Microsoft Documentation

The .NET framework is surrounded by a lot of documentation.
However a lot of it leaves much to be desired.

There is a classic joke about a helecopter pilot that is lost in fog in Seatle.
He hovers near an office block and shouts out “Where am I?”
Upon hearing the answer “You are in a helecopter” he knows that he is at
Microsoft HQ’s documentation department and is able to fly diretly back to the
airport. The answer being both entirely accurate and completely useless.

This is a classic example. I have been trying to find out the purpose of
the EditorBrowsableState.Advanced option.

The documentation reads:

The property or method is a feature that only advanced users should see. An editor can either show or hide such properties.

This is again entirely accurate but completly useless.

The sample code that is linked to uses the EditorBrowsableState.Never option.
Why document the obvious case?

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s