search

camunda / camunda-docs

Camunda 8 Documentation, including all components and features
https://docs.camunda.io/
Other
54 stars 182 forks source link

Why is there XML in Cloud Modeler Docs? #834

Open davidgs opened 2 years ago

davidgs commented 2 years ago

this page among many others includes snippets of XML. If these are Camunda 8 docs, referencing Camunda Web Modeler, why are we including things like this: 

<definitions xmlns="https://www.omg.org/spec/DMN/20191111/MODEL/" id="dinnerDecisions" name="Dinner Decisions"
             namespace="http://camunda.org/schema/1.0/dmn">
    <decision id="dish" name="Dish">
        <!-- ... -->
    </decision>
    <decision id="beverages" name="Beverages">
        <!-- ... -->
    </decision>
</definitions>

in the docs? There is no way to actually view or edit the raw XML of any Cloud Modeler generated DMN table, Form or BPMN. It just adds confusion

akeller commented 2 years ago

@saig0 - another DMN topic. Was this copied over from the C7 docs as well? Is it applicable to C8 users and SaaS? Or do we need to mention that this is useful but requires Desktop Modeler?

saig0 commented 2 years ago

Was this copied over from the C7 docs as well?

Yes.

Is it applicable to C8 users and SaaS?

Both. You can use the Desktop Modeler also for Saas.

Or do we need to mention that this is useful but requires Desktop Modeler?

I guess we could. But I'm in favor of dropping the XML snipped when doing a rewrite of the DMN reference docs (at some point).

akeller commented 2 years ago

Can you create an issue for the DMN reference docs rewrite? 🙂

saig0 commented 2 years ago

@akeller done. I created #858