Conflicting guidelines for HTML documentation conventions for tables

[dietmarw]

In Modelica.UsersGuide.Conventions.Documentation.Format.Tables the guidelines say that the caption should be defined as:

<caption align="bottom"><strong>Tab 2:</strong> Caption starts with a capital letter</caption>

But this would place the caption at the bottom and not the top. The problem is that Dymola renders the position incorrectly and always displays it on the top. Now the question, should the caption appear at the top of the table or the bottom. If at the top then it needs to be updated and tools need to make sure to get the rendering right.

One additional problem is that align is no longer supported in HTML5, so the guideline should most likely updated anyway.

[christiankral]

I assume we do not have a decision yet, if HTML5 is the standard that the MLS and the MSL rely on, see modelica/ModelicaSpecification#2395.

However, we could

1. remove align from the MSL documentation

<caption><strong>Tab 2:</strong> Caption starts with a capital letter</caption>

2. and do not specify where the caption shall be placed and thus leave it up to the tool vendors how they implement it

[dietmarw]

I agree that is the most practical and pragmatic solution and also future proof. I'll create a PR to remove it.