Describe more element replacement details In the "Content Completion" dialog documentation

[chrispy-snps]

In step 2 of the the "Customizing the Content Completion Assistant for Author Mode Only", it would be helpful to explicitly mention the following:

• If you set the "Replacement for" field, you do not need to add the element to the "Filter - Remove content completion items" list.
• If you set the "Display item only when element is allowed at cursor" checkbox, you do not need to define a "oxy:allows-child-element" activation XPath in the "Author Action" dialog.

[raducoravu]

I added more details about the "Replacement for" field, @StevenHiggs when you have the time maybe you can check my modifications. About this remark:

 If you set the "Display item only when element is allowed at cursor" checkbox, you do not need to define a "oxy:allows-child-element" activation XPath in the "Author Action" dialog.

from what I checked the activation XPath is no longer checked when you invoke the content completion window but it is still checked when you press enter to invoke the action in the content completion window. @chrispy-snps my changes in the user's guide look something like this.

Use this section to replace an existing element with the configured action:
 Element name, Namespace fields - Define the name (and namespace, if needed) of the replaced element. The original element no longer needs to be excluded using the Filter - Remove content completion items table.
 Display item only when element is allowed at cursor - The configured action is contributed in the UI components selected in the Contribute to section only if the associated schema allows the original element at the current location in the document. This is equivalent to defining activation XPaths in the Author Action dialog box using the oxy:allows-child-element() XPath extension function. Activation XPaths for the action are still checked when the action is invoked.