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 getting started doc #3596

Merged

Conversation

camilamacedo86
Copy link
Member

@camilamacedo86 camilamacedo86 commented Sep 6, 2023

Description

This PR introduces an overview or summary to assist users in getting started more smoothly. We've designed this document to address the most frequently asked initial questions.

While the tutorials offer in-depth information, this document aims to provide a broad understanding in a more concise manner.

See the preview: https://deploy-preview-3596--kubebuilder.netlify.app/getting-started

Closes: #3203

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Sep 6, 2023
@k8s-ci-robot k8s-ci-robot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. approved Indicates a PR has been approved by an approver from all required OWNERS files. labels Sep 6, 2023
@camilamacedo86 camilamacedo86 requested review from Sajiyah-Salat and removed request for everettraven and varshaprasad96 September 6, 2023 08:27
@camilamacedo86
Copy link
Member Author

/test pull-kubebuilder-e2e-k8s-1-26-0

docs/book/src/getting-started.md Outdated Show resolved Hide resolved
- Not allow more instances than the size defined in the CR which will be applied
- Update the Memcached CR status

Following the steps.
Copy link
Contributor

@Sajiyah-Salat Sajiyah-Salat Sep 11, 2023

Choose a reason for hiding this comment

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

Suggested change
Following the steps.
###Following the steps.

in preview following the steps feels like out of place it should br near to create a project.

Copy link
Member Author

Choose a reason for hiding this comment

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

The text following the steps should not be a subsection. It is just a description to let the audience be aware that the steps will be provided bellow.

Copy link
Contributor

Choose a reason for hiding this comment

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

image

To me this doesnt looks good. I mean the format. I think we should either add something after following the steps or remove it or make it near create the project. What say?

docs/book/src/getting-started.md Outdated Show resolved Hide resolved
docs/book/src/getting-started.md Outdated Show resolved Hide resolved
docs/book/src/getting-started.md Show resolved Hide resolved
docs/book/src/getting-started.md Outdated Show resolved Hide resolved
@Sajiyah-Salat
Copy link
Contributor

Hello @camilamacedo86 I have done review for the first time. maybe there are suggestions that are not important. Kindly ignore that. I am learning.

@camilamacedo86 camilamacedo86 force-pushed the add-getting-started-doc branch 2 times, most recently from dc4d29c to 8d04edb Compare September 11, 2023 08:15
@camilamacedo86
Copy link
Member Author

HI @Sajiyah-Salat,

Thank you for your review. The suggestions were addressed could you please check it out and LGTM if you are OK with it?

@camilamacedo86
Copy link
Member Author

/test pull-kubebuilder-e2e-k8s-1-27-1

@Sajiyah-Salat
Copy link
Contributor

I will check that shortly

@Sajiyah-Salat
Copy link
Contributor

Everything looks good. Just check this comment
LGTM

docs/book/src/getting-started.md Outdated Show resolved Hide resolved
docs/book/src/getting-started.md Outdated Show resolved Hide resolved
docs/book/src/getting-started.md Outdated Show resolved Hide resolved
// Look for Database CR/CRD
// Check the Database Deployment's replicas size
// If deployment.replicas size doesn't match cr.size, then update it
// Then, restart from the beginning of the reconcile
Copy link
Member

Choose a reason for hiding this comment

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

Can we add the comment that in this case we Requeue the reconcile request even when there is no error.

}
```

#### Return Options
Copy link
Member

Choose a reason for hiding this comment

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

Do we need the previous section. Aren't the previous and current one kind of repetitive?

Copy link
Member Author

Choose a reason for hiding this comment

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

It seems for me that we have not doc in any place all options.
So, I think that would be great keep this one. WDYT? Can we keep it?

docs/book/src/getting-started.md Outdated Show resolved Hide resolved
@k8s-ci-robot k8s-ci-robot added do-not-merge/invalid-commit-message Indicates that a PR should not merge because it has an invalid commit message. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Sep 13, 2023
@k8s-ci-robot k8s-ci-robot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed do-not-merge/invalid-commit-message Indicates that a PR should not merge because it has an invalid commit message. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. labels Sep 13, 2023
@camilamacedo86
Copy link
Member Author

@varshaprasad96

Thank you for your review.
I think I addressed all your comments/suggestions.
WDYT? Could we move with this one?

Copy link
Member

@varshaprasad96 varshaprasad96 left a comment

Choose a reason for hiding this comment

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

/lgtm
/approve

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Sep 18, 2023
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: camilamacedo86, grzesuav, varshaprasad96

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:
  • OWNERS [camilamacedo86,varshaprasad96]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot merged commit 0827940 into kubernetes-sigs:master Sep 18, 2023
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. lgtm "Looks good to me", indicates that a PR is ready to be merged. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Doc] - Create doc with common suggestions and overview
5 participants