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

Update README.md to include list of rules #82

Merged
merged 4 commits into from Oct 26, 2019
Merged

Conversation

jbouter
Copy link
Member

@jbouter jbouter commented Oct 25, 2019

  • Add a table with all rules, linking to corresponding wiki entries

- Add a table with all rules, linking to corresponding wiki entries

Signed-off-by: Jeffrey Bouter <jb@warpnet.nl>
@roaldnefs roaldnefs changed the title Update readme Update README.md to include list of rules Oct 25, 2019
@roaldnefs roaldnefs added the Type: Enhancement New feature or request label Oct 25, 2019
README.md Outdated Show resolved Hide resolved
| [210](https://github.com/warpnet/salt-lint/wiki/210) | Numbers that start with `0` should always be encapsulated in quotation marks |
| [211](https://github.com/warpnet/salt-lint/wiki/211) | `pillar.get` or `grains.get` should be formatted differently |
| [212](https://github.com/warpnet/salt-lint/wiki/212) | Most files should not contain irregular spaces |

Copy link
Contributor

Choose a reason for hiding this comment

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

Also, I believe issue #70 was about having more detailed explanations (the why). So all of the content here will probably have to be expanded.

Copy link
Contributor

Choose a reason for hiding this comment

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

OK, this part is a non-issue, since the links lead to the wiki. It's funny, I didn't see the link immediately when looking at this from View file. Perhaps I wouldn't have missed it as easily if the main statement was the link? More noticeable, perhaps.

Copy link
Contributor

Choose a reason for hiding this comment

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

So perhaps the rule numbers in bold and the main text as the links? Just some thoughts for you to consider, feel free to ignore this suggestion.

Copy link
Member

Choose a reason for hiding this comment

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

Thanks @myii for your suggestion, I will leave this one open for @jbouter to decide!

Copy link
Member Author

Choose a reason for hiding this comment

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

I've based the table on how hadolint does it, and I find it quite easy and nice to use. If you could, please have a look how hadolint's table feels to you, @myii, and tell me. :-) If acceptable, I'd like to implement it how I've currently designed it.

Copy link
Contributor

Choose a reason for hiding this comment

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

@jbouter Sure, keep it that way. I just didn't see the link at first, that's all! But I'm sure it will be fine.

The one thing that probably needs adjusting is whether to use leading and trailing bars (|) or not. So the line that has been modified should follow the same system as the rest of the table.

Thanks for providing this feature, by the way.

Copy link
Member Author

Choose a reason for hiding this comment

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

Hey @myii, thanks for your review. I've modified the table to be simpler to edit as per your suggestion. Could you review it once more?

Copy link
Contributor

Choose a reason for hiding this comment

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

@jbouter Sure, it looks nice and tidy, thanks!

Update rules list in `README.md` to simply the markdown table.

Co-Authored-By: Imran Iqbal <myii@users.noreply.github.com>
- Simplify the markdown table as per @myii his recommendations

Signed-off-by: Jeffrey Bouter <jb@warpnet.nl>
@jbouter jbouter merged commit 5532d70 into develop Oct 26, 2019
@jbouter jbouter deleted the readme-ruletable branch October 26, 2019 07:29
This was referenced Nov 1, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Type: Enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants