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

Add best practices page #6478

Merged
merged 64 commits into from Jul 13, 2023

Conversation

MarkEWaite
Copy link
Contributor

@MarkEWaite MarkEWaite commented Jun 17, 2023

Add best practices page

Extracted from the wiki by JE-Chen with addtions by MarkEWaite.

Fixes #3209

Must be squash merged

Would like reviews from:

Some text is still missing, but I think it is worth review even with the current gaps in the content.

Associated with

Second half of original pull request from @JE-Chen

See the prototype Best Practices page

JE-Chen and others added 30 commits May 26, 2023 10:23
Add to _chapter and add docs
Add Administering Jenkins
Make http://[jenkins-server]/[command]  pretty
Refactor doc string
Add example picture and edit text.
Edit text
Extract section to another page.
* Extract `JENKINS_HOME` directory section to system-configuration.adoc
* Extract Moving/Copying/Renaming jobs to create-project.adoc
Fix title and add to _chapter.yml
Make link on next line not same as intro.
@MarkEWaite
Copy link
Contributor Author

@StackScribe, @JE-Chen, and @kmartens27 this is ready for your review

@JE-Chen
Copy link
Contributor

JE-Chen commented Jul 7, 2023

LGTM

Remember the rule of seven as described by Meg McRoberts.  Readers are
more likely to retain the contents of a list if it includes no more
than 7 items.
Copy link
Contributor

@gounthar gounthar left a comment

Choose a reason for hiding this comment

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

Thanks a lot for this guide! 👍

content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
Co-authored-by: Bruno Verachten <gounthar@gmail.com>
Copy link
Contributor

@kmartens27 kmartens27 left a comment

Choose a reason for hiding this comment

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

This looks great @MarkEWaite, I provided a few suggestions for syntax/word choices, and some formatting/punctuation updates, but apply as you feel is appropriate.

content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Outdated Show resolved Hide resolved
content/doc/book/using/best-practices.adoc Show resolved Hide resolved
MarkEWaite and others added 2 commits July 7, 2023 15:59
Co-authored-by: Kevin Martens <99040580+kmartens27@users.noreply.github.com>
Co-authored-by: Bruno Verachten <gounthar@gmail.com>
@kmartens27 kmartens27 merged commit d40bbbc into jenkins-infra:master Jul 13, 2023
8 checks passed
@MarkEWaite MarkEWaite deleted the add-best-practices-page branch July 13, 2023 17:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Jenkins documentation, including user and developer docs, solution pages, etc.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Convert 'Jenkins Best Practices' wiki page to jenkins.io
4 participants