docs: plasma: Weblate-ready tables and improved optics (docs_misc_9)

[smoe]

The changes to the tables are important. The rest is just optics.

[silopolis]

Le mer. 21 sept. 2022 à 16:01, Steffen Möller ***@***.***> a écrit :

The changes to the tables are important. The rest is just optic

Speaking of optics, those special chars really tend to make my eyes bleed 😫

[hansu]

Speaking of optics, those special chars really tend to make my eyes bleed 😫

I suggested to simply insert the Unicode characters...

[silopolis]

Le jeu. 22 sept. 2022 à 14:40, Hans Unzner ***@***.***> a écrit :

Speaking of optics, those special chars really tend to make my eyes bleed 😫 I suggested to simply insert the Unicode characters...

May be a relief... Provided the writer knows how to key them in! Which I don't 🤭

[smoe]

I suggest not to bother about anything that can be addressed with a recursive sed -i . And while I do not know how to key those in, we will figure this out, eventually. The challenge for now it to decide where to place those characters and how to know that such a special character is already in place. So, for the moment, I think thos   and &#whatever: are doing a very good job.

[hansu]

@smoe: It's sometimes a bit difficult to find the corresponding PR when looking at your branches. It would be nice if you could add a reference like I did e.g. for the next ones. Thanks.

[silopolis]

Le ven. 23 sept. 2022 à 00:16, Steffen Möller ***@***.***> a écrit :

I suggest not to bother about anything that can be addressed with a recursive sed -i . And while I do not know how to key those in, we will figure this out, eventually. The challenge for now it to decide where to place those characters and how to know that such a special character is already in place. So, for the moment, I think thos and &#whatever: are doing a very good job.

Just stumbled on it via https://redhat-documentation.github.io/asciidoc-markup-conventions/... Maybe we can embrace AsciiDoc character replacement attribute principle (see https://asciidoc-py.github.io/userguide.html#X60 and https://docs.asciidoctor.org/asciidoc/latest/attributes/character-replacement-ref/) and extend it with {thinsp} and/or any other not in the list !?

[smoe]

Rebased + squashed. Manually went through it - looked fine to me.

[smoe]

We should have a docs-wide check on how the Mesa cards are spelled (all in caps on the Mesa website) and volts/ampere/watt - should all start with a capital. I caught most of them by now, I think, but these small ones keep escaping me.

[silopolis]

We should have a docs-wide check on how the Mesa cards are spelled (all in caps on the Mesa website) and volts/ampere/watt - should all start with a capital. I caught most of them by now, I think, but these small ones keep escaping me.

Absolutely !
I'd like us to explore Vale for this. See:

• https://vale.sh/
• https://docs.gitlab.com/ee/development/documentation/testing.html#vale
• https://redhat-documentation.github.io/vale-at-red-hat/docs/user-guide/introduction/

[silopolis]

Le mar. 11 oct. 2022 à 22:55, Steffen Möller ***@***.***> a écrit :

I need a better previewer - or the transition just needs to happen.

I second that !

[smoe]

Rebase and squash to master. Think to have done as requested.