Hint boxes broken (if used in a DocuBlock)

[Simran-B]

Content missing and stray closing divs:

https://www.arangodb.com/docs/stable/drivers/js-reference-database-transactions.html#databasetransaction

Markdown not processed:

https://www.arangodb.com/docs/3.5/data-modeling-documents-document-address.html#document-revision

The callouts work in other places however.

The first issue is probably whitespace related. The HintBlock.rb script does not remove leading whitespace from the input based on the indentation of the first line. This shouldn't result in a completely messed up markup however...

The second issue is DocuBlock related: the content comes from Documentation/DocuBlocks/documentRevision.md via allComments.txt.

[Simran-B]

The first issue should be resolved by #51 - nonetheless it is strange that htmltest did not complain about the closing dives wrapped in a p element...

[Simran-B]

Documentation\DocuBlocks\documentRevision.md is a "simple" DocuBlock:

@startDocuBlock documentRevision

Every document in ArangoDB has a revision…

{% hint 'warning' %}
From a **user perspective**, there is just **one single document revision
present per different `_key`** at every point in time. There is no built-in
system to automatically keep a history of all changes done to a document
and old versions of a document can not be restored via the `_rev` value.
{% endhint %}

@endDocuBlock

The problem is most likely that the content is included at the Markdown processing stage, which comes after the pre-processing of Jekyll ({% ... %} resolution occurs prior to that). So this is actually handed verbatim to the Markdown processor, to which the hint tag is plain text.

[Simran-B]

Fixed by d849093