DMN15-44 Clarify equivalence of date vs date and time

[falko]

This is an example pull request that illustrates how the changes of the following issue would be expressed in Git: https://issues.omg.org/browse/DMN15-44

Reviewing this change as a diff is far superior that reading the editing instructions in JIRA.

Rendering before: https://github.com/omg-dmn-taskforce/plain-text-spec/blob/main/10-expression-language-FEEL.adoc#type-conversions

Rendering after: https://github.com/omg-dmn-taskforce/plain-text-spec/blob/DMN15-44/10-expression-language-FEEL.adoc#type-conversions

[falko]

Currently, the diff itself is not rendered. I wonder if that is due to AsciiDoc or due to the file size. When I switch between source diff and rich diff I'm getting this error:

We’re unable to render the document prior to diffing, sorry.
Next steps:

• try a smaller AsciiDoc file
• try Markdown instead

[rivettp]

Maybe GitHub has changed, but I'm able to see both source and rich diffs (which I didn't even know existed until you mentioned them!). I agree it's a great improvement for basic changes, but have the following reservations:

• does not obviously allow for an explanation of the change e.g. "change the subject of the sentence from "the" to "a" to make it clear there could be many". In many cases it will be obvious, but would be interested in others' opinions
• not sure how well it would cope with larger scale reorganizations such as moving a chunk of text from one section to another part of the document or an Annex.

However I think use of diffs should cope with 90% of the issues (rough guess) and we could think of conventions for representing the remainder of the changes to supplement the diffs.