Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Documentation] Markdown improvements t to z #14371

Merged
merged 13 commits into from
Apr 11, 2023

Conversation

Confectrician
Copy link
Contributor

This is a bulk pr for getting some consistency into the doc markdown files.

Reference for a general linting approach here: #13858
Discussion Reference for codeblock styles i have applied: openhab/openhab-docs#999

(Sorry again for the many review requests, there is plenty much to improve in the repo. 🤷‍♂️)

Copy link
Contributor

@jlaur jlaur left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Half-way comments.

bundles/org.openhab.binding.telegram/README.md Outdated Show resolved Hide resolved
| threePhasedLSMGroup#smaxsn*X*Minus1 | `Number:Power` | Maximum withdrawn apparent power on the previous day on phase *X*, *X* in {1,2,3} |
| threePhasedLSMGroup#smaxs*X*nDate | `DateTime` | Timestamp of SMAXSN*X* value, *X* in {1,2,3} |
| threePhasedLSMGroup#smaxsn*X*Minus1Date | `DateTime` | Timestamp of SMAXSN*X*-1 value, *X* in {1,2,3} |
| threePhasedLSMGroup#irms_X_ | `Number:ElectricCurrent` | RMS Current on phase _X, X_ in {2,3} |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here and in the next rows: I think intention here was to underline each X individually without the comma?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is on purpose as is now.
I have tried several options to make this pass markldown linting and also keep the existing intention from the old markup.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would like to resolve this, if you don't see any bigger issue with this.

From the rich diff here in the PR it looks quite good.
We can check it anyway after merging and see how vuepress will render this in the next homepage.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's merge this, it's not that important, just wanted to check if intentional from a formatting perspective, since I don't know exactly what triggers the linting. 🙂

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One thing though, can we have the alignment of this table as well as the previous/next tables restored?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have committed alignment fixes.

bundles/org.openhab.binding.valloxmv/README_DEV.md Outdated Show resolved Hide resolved
bundles/org.openhab.binding.valloxmv/README_DEV.md Outdated Show resolved Hide resolved
Copy link
Contributor

@jlaur jlaur left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Now done. Thanks a lot for fixing the documentation from A to Z.

bundles/org.openhab.binding.vigicrues/README.md Outdated Show resolved Hide resolved
bundles/org.openhab.binding.yioremote/README.md Outdated Show resolved Hide resolved
@Wolfgang1966
Copy link

LGTM tacmi. Thank you!

@lsiepel
Copy link
Contributor

lsiepel commented Feb 28, 2023

Think it is a good idea to not leave this PR hanging too long because it has the potential to cause many merge conflicts :-/

@jlaur
Copy link
Contributor

jlaur commented Mar 1, 2023

@Confectrician, did you have a chance to look into the comments? There is also a conflict to resolve.

Signed-off-by: Jerome Luckenbach <[email protected]>

Co-authored-by: Jacob Laursen <[email protected]>
@Confectrician
Copy link
Contributor Author

Sorry for the delay @jlaur.
I think i have addressed everything, resolved all conflicts and commetned on one conversation from your side.

Ready for the next round or merge, when already suitable.

Copy link
Contributor

@jlaur jlaur left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Preparing batch for committing small alignment fix.

bundles/org.openhab.binding.teleinfo/README.md Outdated Show resolved Hide resolved
bundles/org.openhab.binding.teleinfo/README.md Outdated Show resolved Hide resolved
bundles/org.openhab.binding.teleinfo/README.md Outdated Show resolved Hide resolved
bundles/org.openhab.binding.teleinfo/README.md Outdated Show resolved Hide resolved
bundles/org.openhab.binding.teleinfo/README.md Outdated Show resolved Hide resolved
bundles/org.openhab.binding.teleinfo/README.md Outdated Show resolved Hide resolved
bundles/org.openhab.binding.teleinfo/README.md Outdated Show resolved Hide resolved
Signed-off-by: Jacob Laursen <[email protected]>
Signed-off-by: Jacob Laursen <[email protected]>
Signed-off-by: Jacob Laursen <[email protected]>
Copy link
Contributor

@jlaur jlaur left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@jlaur jlaur merged commit ce3f673 into openhab:main Apr 11, 2023
@jlaur jlaur added this to the 4.0 milestone Apr 11, 2023
@Confectrician Confectrician deleted the markdown-improvements-t-to-z branch April 11, 2023 18:29
FordPrfkt pushed a commit to FordPrfkt/openhab-addons that referenced this pull request Apr 20, 2023
* Apply markdown fixes for bindings with letter _t_
* Apply markdown fixes for bindings with letter _u_
* Apply markdown fixes for bindings with letter _v_
* Apply markdown fixes for bindings with letter _w_
* Apply markdown fixes for bindings with letter _x_
* Apply markdown fixes for bindings with letter _y_
* Apply markdown fixes for bindings with letter _z_

Signed-off-by: Jerome Luckenbach <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.