Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

References to SDK subjects from end user content #45

Open
mbakeranalecta opened this issue Aug 29, 2014 · 1 comment
Open

References to SDK subjects from end user content #45

mbakeranalecta opened this issue Aug 29, 2014 · 1 comment

Comments

@mbakeranalecta
Copy link
Contributor

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?

@georgebina
Copy link
Contributor

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants