Collapsible property description markdown does not function as documented

[stephen-sherman]

Which Umbraco version are you using? (Please write the exact version, example: 10.1.0)

15.1.0

Bug summary

The Umbraco 15 documentation states that a collapsible property description can be made as follows:

Instead, this results in the preceding block of text being rendered as an h2.

Specifics

No response

Steps to reproduce

1. Create a new Umbraco 15.1.0 solution
2. Create a document type with a property description as documented:

this is initially shown
--
this is initially hidden

3. Create a node with the document type
4. Observe the format of the property description

Expected result / actual result

No response

[github-actions]

Hi there @stephen-sherman!

Firstly, a big thank you for raising this issue. Every piece of feedback we receive helps us to make Umbraco better.

We really appreciate your patience while we wait for our team to have a look at this but we wanted to let you know that we see this and share with you the plan for what comes next.

• We'll assess whether this issue relates to something that has already been fixed in a later version of the release that it has been raised for.
• If it's a bug, is it related to a release that we are actively supporting or is it related to a release that's in the end-of-life or security-only phase?
• We'll replicate the issue to ensure that the problem is as described.
• We'll decide whether the behavior is an issue or if the behavior is intended.

We wish we could work with everyone directly and assess your issue immediately but we're in the fortunate position of having lots of contributions to work with and only a few humans who are able to do it. We are making progress though and in the meantime, we will keep you in the loop and let you know when we have any questions.

Thanks, from your friendly Umbraco GitHub bot 🤖 🙂

[iOvergaard]

I have taken the liberty to move this to our UmbracoDocs issues as we need to update the documentation. The correct syntax is to use the <details> element like this:

<details>
  <summary>this is initially shown</summary>
  this is initially hidden
</details>

This syntax follows the HTML standard of making a collapsible element (MDN).