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

docs: improve Notes within the documentation #962

Merged
merged 3 commits into from
Mar 20, 2023

Conversation

aepfli
Copy link
Member

@aepfli aepfli commented Mar 3, 2023

With this little changes, Notes are way better visible and
follow the standard definition which can also be used within
GitHub markdown.

Instead of

NOTE: a note

we do

Note
a note

@aepfli aepfli added the documentation Improvements or additions to documentation label Mar 3, 2023
@netlify
Copy link

netlify bot commented Mar 3, 2023

Deploy Preview for keptn-lifecycle-toolkit ready!

Name Link
🔨 Latest commit 8864428
🔍 Latest deploy log https://app.netlify.com/sites/keptn-lifecycle-toolkit/deploys/640b1e92cd51ae00086e7b6e
😎 Deploy Preview https://deploy-preview-962--keptn-lifecycle-toolkit.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site settings.

@aepfli
Copy link
Member Author

aepfli commented Mar 3, 2023

waiting for #963 to get merged, to solve the markdown issues

@aepfli
Copy link
Member Author

aepfli commented Mar 3, 2023

Comparison of old versus new

new old
image image
image image
image image

StackScribe
StackScribe previously approved these changes Mar 3, 2023
Copy link
Contributor

@StackScribe StackScribe left a comment

Choose a reason for hiding this comment

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

lgtm -- thanks. I need to find a place to document this since it is not actually a CSS/tools change but rather a coding convention. For now, I added it to the Word list for discussion. We'll figure out what to do with it when we start writing up issues that the community has approved.

With this little changes, `Notes` are way better visible and
follow the standard definition which can also be used within
GitHub markdown.

Instead of

**NOTE:** a note

we do

> **Note**
a note

Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
thisthat
thisthat previously approved these changes Mar 7, 2023
Copy link
Member

@thisthat thisthat left a comment

Choose a reason for hiding this comment

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

Nice addition! Thanks @aepfli

Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
thschue
thschue previously approved these changes Mar 9, 2023
Copy link
Contributor

@thschue thschue left a comment

Choose a reason for hiding this comment

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

lgtm

@aepfli
Copy link
Member Author

aepfli commented Mar 9, 2023

#1031 is a demo, of a markdown-lint rule to prevent this, and to fix this automatically :)

Signed-off-by: Simon Schrottner <simon.schrottner@dynatrace.com>
@aepfli aepfli dismissed stale reviews from thschue and thisthat via 8864428 March 10, 2023 12:11
@sonarcloud
Copy link

sonarcloud bot commented Mar 10, 2023

Kudos, SonarCloud Quality Gate passed!    Quality Gate passed

Bug A 0 Bugs
Vulnerability A 0 Vulnerabilities
Security Hotspot A 0 Security Hotspots
Code Smell A 0 Code Smells

No Coverage information No Coverage information
0.0% 0.0% Duplication

Copy link
Contributor

@thschue thschue left a comment

Choose a reason for hiding this comment

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

lgtm

@thschue thschue merged commit 4e69699 into keptn:main Mar 20, 2023
@keptn-bot keptn-bot mentioned this pull request Mar 22, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants