[ https://issues.jboss.org/browse/DROOLS-2888?page=com.atlassian.jira.plugi... ] Stetson Robinson edited comment on DROOLS-2888 at 8/20/18 1:40 PM: ------------------------------------------------------------------- [~uxdlc], [~karreiro], Here's my proposed re-write of the data types help, based on my understanding: Collapsed "Data types determine the input and output values in DMN decision tables. You can use basic data types (example, Boolean) or you can use this dialog to create custom data types." View more >>" Expanded Data types determine the input and output values in DMN decision tables. You can use basic data types (example, Boolean) or you can use this dialog to create custom data types." Custom data types that you create in this dialog can be *Simple* or *Structured* data types: • *Simple* data types have only a name and a type assignment. Example: "Age (Number)" • *Structured* data types contain fields and are more complex. A single type "Person" may define a number of fields within it. Example: "name (String), age (Number), email (String)." View less >> The main thing we want to watch for is passive, feature-centric language. We want instead user-centric language that speaks to the user and says exactly what the use can or must do. Also, I'm not sure how we feel about linking to documentation from the UI, but our latest DMN document (to be retro-actively published to DM/PAM 7.0) describes each available data type and that will continue to be the case when this is released in 7.2. It won't be long before I have a fairly reliable 7.2 URL for that. I know with linking docs from UI there are gains (added info, doc promotion, better odds of user success) as well as losses (content out of sync, broken links) but it's a discussion that's being had around CCS. It sounds like there are ways to automate or otherwise facilitate the linking and syncing issue, but still a matter of optimal user success and opinion. This is also more prominent a discussion as community and product docs become single-sourced, and DMN will be the very first to do so :) I will be making this happen immediately after the new kie-docs repo structure is merged in the coming days/week-ish. Just food for thought. I should add also that we always want to specify "DMN decision tables", which are distinct (in supported features) from the guided or uploaded decision tables used elsewhere in the workbench. I know we know, but just a reminder for any communication to the user, to avoid confusion. was (Author: stetson.robinson): [~uxdlc], [~karreiro], Here's my proposed re-write of the data types help, based on my understanding: Collapsed "Data types determine the input and output values in DMN decision tables. You can use basic data types (example, Boolean) or you can use this dialog to create custom data types." View more >>" Expanded Data types determine the input and output values in DMN decision tables. You can use basic data types (example, Boolean) or you can use this dialog to create custom data types." Custom data types that you create in this dialog can be Simple or Structured data types: • Simple data types have only a name and a type assignment. Example: "Age (Number)" • Structured data types contain fields and are more complex. A single type "Person" may define a number of fields within it. Example: "name (String), age (Number), email (String)." View less >> The main thing we want to watch for is passive, feature-centric language. We want instead user-centric language that speaks to the user and says exactly what the use can or must do. Also, I'm not sure how we feel about linking to documentation from the UI, but our latest DMN document (to be retro-actively published to DM/PAM 7.0) describes each available data type and that will continue to be the case when this is released in 7.2. It won't be long before I have a fairly reliable 7.2 URL for that. I know with linking docs from UI there are gains (added info, doc promotion, better odds of user success) as well as losses (content out of sync, broken links) but it's a discussion that's being had around CCS. It sounds like there are ways to automate or otherwise facilitate the linking and syncing issue, but still a matter of optimal user success and opinion. This is also more prominent a discussion as community and product docs become single-sourced, and DMN will be the very first to do so :) I will be making this happen immediately after the new kie-docs repo structure is merged in the coming days/week-ish. Just food for thought. -- This message was sent by Atlassian JIRA (v7.5.0#75005)