user doc: add xref from general json def file info to ui details
@@ -113,13 +113,15 @@ Syndesis version 1.3, the following extension types are supported:
** `Connectors`
** `Libraries`
-* *properties* defines the global configuration options that are
-supported by the extension. Only connector extensions use
-properties that you specify. For example:
+* *properties* at the top level in a connector extension controls
+what {prodname} displays when a {prodname} user selects the connector
+to create a connection. This `properties` object contains a set
+of properties for each form control for creating a connection.
+For example:
+
[source,json]
----
-"propertyName": {
+"myControlName": {
"deprecated": true|false,
"description": "",
"displayName": "",
@@ -135,6 +137,13 @@ properties that you specify. For example:
}
}
----
++
+In connector extensions, nested `properties` objects define HTML form controls for
+configuring connection actions.
+In step extensions, the `actions` object contains a `properties`
+object. The `properties` object defines a set of properties for
+each form control for configuring the step. See also:
+link:{LinkFuseOnlineIntegrationGuide}#descriptions-of-user-interface-properties-in-extension-definitions_extensions[Descriptions of user interface properties].
* *actions* defines the operations that a connector can perform or the
operation that a step between connections can perform. Only connector
