What goes in product knowledge?

When you create a component in a management pack, you have to provide a display name. You can also include a description and product knowledge. All three of those items are pretty much free-form, meaning you can put what you want in those fields (subject to character limitations, of course). That means that every MP developer has had to make decisions about when to use those fields and what to put in them.

That's just not a good use of a developer's time, and it also results in an inconsistent experience for customers using MPs from different developers. To help reduce that problem internally, we came up with guidelines for text in MPs: specifically, display names, descriptions, and product knowledge. One of our program managers suggested we provide similar guidance for developers and authors outside of Microsoft, so I cleaned it up (removed resources and links that are internal) and it's now available on OpsManJam: Guidelines for MP Text.

(edit: fixed typo)