I can read how to model a DMN

[saig0]

With Zeebe 1.3, we implement that a business rule task can evaluate a DMN decision.

We should add a new section to the reference for DMN. It should describe what parts of DMN are supported, how to use a decision table, and how to use a literal expression.

It may look similar to https://docs.camunda.org/manual/7.16/reference/dmn/. Since Zeebe uses a different DMN engine, we can't copy the content completely.

We need to think about where to store the documentation. The FEEL docs are located in the FEEL-Scala project and are copied into the docs. For DMN it is kind of similar because we will share the same DMN engine with Camunda Platform 7.

[akeller]

@christinaausley's tasked with creating a platform agnostic guide for DMN which will likely cover "how to use a decision table". When this is closer to being complete on the engineering side, can you sync with us on how to document this experience?

[saig0]

@akeller just to make it clear, who should write the documentation for DMN? the engineering team? what is the concrete task of @christinaausley?

[akeller]

We are moving Modeler documentation from docs.camunda.org to docs.camunda.io, which will include DMN but will be marked "Platform-only". You can see that work on #415.

@christinaausley will work on drafting guides for BPMN, DMN, and forms reusing some existing content. These guides will be agnostic if possible, meaning they should apply to both Cloud and Platform where possible.

The engineering team should plan to write the rest of the DMN documentation, including reviewing the DMN guide to make sure functionality added to Cloud works as documented.

[saig0]

@akeller thank you for the information 👍

When can we expect the agnostic DMN documentation from @christinaausley?
We want to launch DMN in Camunda Cloud with version 1.4 (end of Q1 2022). For the release, we should have a DMN doc for the users.

[akeller]

That should be in line with what @christinaausley can do 🙂

[korthout]

Ping @barmac, just to keep you in the loop

[akeller]

Recapping a meeting we had this morning led by @saig0 with myself, @korthout, @christinaausley and @barmac:

• @akeller will copy existing Camunda Platform docs for DMN into a branch with a PR next week (last week of Feb)
• @saig0 will review and rewrite for the SaaS first, Camunda Cloud-based experience since the DMN engines for Camunda Cloud and Camunda Platform are different yet similar.
• @barmac assess screenshots, ideally, part of the automated screenshot process Modeler uses
• @akeller to sync with @berndruecker to update Migrating from Camunda Platform guide to include DMN
• @christinaausley will author new basic DMN guide for beginners modeling in DMN (similar to Automating a Process in BPMN)
• target docs completion in April where @akeller and @christinaausley will do a final review before publishing

[barmac]

Probably this is not part of this issue, but it's related to the DMN documentation. At camunda.com, user can download a DMN Cheatsheet. The cheatsheet is Camunda DMN-specific, e.g.

or

Perhaps it makes sense to update the cheatsheet once DMN is supported in the Cloud.

[santanaluiz]

@akeller is the DevRel team planning to create any documentation about Operate usage as well?

[akeller]

@akeller is the DevRel team planning to create any documentation about Operate usage as well?

@santanaluiz In terms of DMN?

I have nothing in the DX backlog, but @Hafflgav or @jwulf do either of you have plans for official or unofficial docs for Operate?

[akeller]

Probably this is not part of this issue, but it's related to the DMN documentation. At camunda.com, user can download a DMN Cheatsheet. The cheatsheet is Camunda DMN-specific, e.g. or

Perhaps it makes sense to update the cheatsheet once DMN is supported in the Cloud.

@barmac can you link me to this cheatsheet? I can work with the marketing team to update it.

[barmac]

Sure, it's available at https://page.camunda.com/wp-dmn-cheat-sheet

[Hafflgav]

@akeller & @santanaluiz - so far I also have no plans about any docs for Operate.
But it might be a good idea to overhaul the cheat sheet you have posted... ;)

[saig0]

Done by #775