Uniform second level list marking

[sympy]

Uniform second level list marking

[asmeurer]

I made it use either, because both produce the same kind of bullet in Markdown. We could normalize it to one or the other for the wiki.

For capital letters, ideally the entries should be complete sentences, so begin with a capital letter (unless the first word is a code item), and end with a period. But it isn't enforced by the bot.

[asmeurer]

The difference seems to be that there is no additional spacing between the items when using -, so maybe that is actually preferred. The Wiki page states *, but some frequent contributors seems to use -.

Is that true?

• - bullet
  • sub - bullet
  • sub - bullet

• * bullet
  • sub * bullet
  • sub * bullet

They seem to be the same at least for GitHub comments. As far as I know -, *, and + all produce the same HTML (<li> elements).

[oscargus]

Good question. It indeed looked like that in the release notes, but I cannot say I see any difference here. Didn't check the HTML either.

OK! I'll update the Wiki when I remember so that the examples are complete sentences. May help a bit.

[oscargus]

It seems like - gives a paragraph environment <p>...</p>, except for the first bullet (or if it is after a *. Check out e.g. the printing section in https://github.com/sympy/sympy/wiki/Release-Notes-for-1.5

<li>
<p>printing</p>
<ul>
<li>Added support for <code>HadamardPower</code> in latex printer. (<a href="https://github.com/sympy/sympy/pull/16474">#16474</a> by <a href="https://github.com/sylee957">@sylee957</a> and <a href="https://github.com/Upabjojr">@Upabjojr</a>)</li>
</ul>
<ul>
<li>Fixed alignment of expressions inside sums in pretty printer (<a href="https://github.com/sympy/sympy/pull/16503">#16503</a> by <a href="https://github.com/anpandey">@anpandey</a>)</li>
</ul>
<ul>
<li>
<p>Add support for <code>HadamardProduct</code> in mathml presentation printer. (<a href="https://github.com/sympy/sympy/pull/16483">#16483</a> by <a href="https://github.com/sylee957">@sylee957</a>)</p>
</li>
<li>
<p>pretty printing of BaseScalar and BaseVector matches the latex form with CoordSys as subscript (<a href="https://github.com/sympy/sympy/pull/16422">#16422</a> by <a href="https://github.com/kangzhiq">@kangzhiq</a> and <a href="https://github.com/smichr">@smichr</a>)</p>
</li>
</ul>
</li>

from

* printing
  - Added support for `HadamardPower` in latex printer. ([#16474](https://github.com/sympy/sympy/pull/16474) by [@sylee957](https://github.com/sylee957) and [@Upabjojr](https://github.com/Upabjojr))

  * Fixed alignment of expressions inside sums in pretty printer ([#16503](https://github.com/sympy/sympy/pull/16503) by [@anpandey](https://github.com/anpandey))

  - Add support for `HadamardProduct` in mathml presentation printer. ([#16483](https://github.com/sympy/sympy/pull/16483) by [@sylee957](https://github.com/sylee957))

  - pretty printing of BaseScalar and BaseVector matches the latex form with CoordSys as subscript ([#16422](https://github.com/sympy/sympy/pull/16422) by [@kangzhiq](https://github.com/kangzhiq) and [@smichr](https://github.com/smichr))

[asmeurer]

Interesting. I don't see anything in the commonmark spec about mixing bullet types. Although I don't know if the GitHub wikis use string commonmark. The spec seems to imply that

is used whenever there is a blank line between the items.

In the printing section of the 1.5 notes, there is clearly more vertical space after the second bullet. So maybe it is worth changing this.

[asmeurer]

Let's modify what the bot produces instead of forcing people to use a certain bullet type. The bot collects list items so the first character should always be -, *, or +, so we can easily canonicalize it.