userguide icon indicating copy to clipboard operation
userguide copied to clipboard

References to SDK subjects from end user content

Open mbakeranalecta opened this issue 11 years ago • 1 comments

There are a number of places where references are made to customization (SDK) subjects from inside end user content. For example, see preferences-schema-aware.dita, which has a reference to AuthorSchemaAwareEditingHandler at the end.

Many readers will be confused by these references. On the other hand, I don't think we should take them out because they could alert users to the possibility of customizing behavior. So I think we need a way to set the apart clearly, so that readers are not confused by them, but are made aware of the possibilities. I would suggest something along the lines of a "Customization note" that points to the possibility of customizing a particular behavior.

Thoughts?

mbakeranalecta avatar Aug 29 '14 15:08 mbakeranalecta

Yes, I think it will be good to have these pointers to SDK consistently marked as a customization note.

georgebina avatar Sep 23 '14 13:09 georgebina