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

Very small updates to Getting Started #1015

Merged
merged 5 commits into from
Jan 4, 2024

Conversation

omerbensaadon
Copy link
Contributor

small updates for clarity

Thank you for helping make the Radius documentation better!

Please follow this checklist before submitting:

  • Read the contribution guide
  • [n/a] Commands include options for Linux, MacOS, and Windows within codetabs
  • [n/a] New file and folder names are globally unique
  • [n/a] Page references use shortcodes instead of markdown or URL links
  • [n/a] Images use HTML style and have alternative text
  • [n/a] Places where multiple code/command options are given have codetabs

In addition, please fill out the following to help reviewers understand this pull request:

Description

Just made a few small changes for clarity as I was going through the Getting Started guide, hopefully these are well-received and thank you in advance for your review!

Issue reference

small updates for clarity

Signed-off-by: Omer Bensaadon <[email protected]>
@@ -77,7 +77,7 @@ In addition to starting Radius services in your Kubernetes cluster, this initial

## 4. Run the app

Use the below command to run the app in your environment, then access the application by opening [http://localhost:3000](http://localhost:3000) in a browser.
Use the below command to run the app in your environment:
Copy link
Contributor Author

Choose a reason for hiding this comment

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

feels more natural to put the link after the command is run, I was left sort of looking for it

In this step you will:

- Add Redis to the application using a Recipe.
- Add Redis to the application using a [Recipe]({{< ref "guides/recipes/overview" >}}) .
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Feels like a situation where talking about Recipes is actually a bit distracting from the main purpose of the Getting Started.

Linking to the concept here is enough I think?

Copy link
Contributor

Choose a reason for hiding this comment

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

Agree on linking to Recipes being enough. Small update:

Suggested change
- Add Redis to the application using a [Recipe]({{< ref "guides/recipes/overview" >}}) .
- Adding a Redis Cache to your app definition, leveraging [Recipes]({{< ref "guides/recipes/overview" >}}) for the underlying infrastructure.

Copy link
Contributor

@AaronCrawfis AaronCrawfis left a comment

Choose a reason for hiding this comment

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

Thanks for the contribution! Love the updates. Left a couple small suggestions for flow and consistency.

docs/content/getting-started/index.md Outdated Show resolved Hide resolved
In this step you will:

- Add Redis to the application using a Recipe.
- Add Redis to the application using a [Recipe]({{< ref "guides/recipes/overview" >}}) .
Copy link
Contributor

Choose a reason for hiding this comment

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

Agree on linking to Recipes being enough. Small update:

Suggested change
- Add Redis to the application using a [Recipe]({{< ref "guides/recipes/overview" >}}) .
- Adding a Redis Cache to your app definition, leveraging [Recipes]({{< ref "guides/recipes/overview" >}}) for the underlying infrastructure.

docs/content/getting-started/index.md Outdated Show resolved Hide resolved
docs/content/getting-started/index.md Outdated Show resolved Hide resolved
Co-authored-by: Aaron Crawfis <[email protected]>
Signed-off-by: Omer Bensaadon <[email protected]>
omerbensaadon and others added 2 commits January 4, 2024 15:16
Co-authored-by: Aaron Crawfis <[email protected]>
Signed-off-by: Omer Bensaadon <[email protected]>
Co-authored-by: Aaron Crawfis <[email protected]>
Signed-off-by: Omer Bensaadon <[email protected]>
@AaronCrawfis AaronCrawfis enabled auto-merge (squash) January 4, 2024 20:33
@AaronCrawfis AaronCrawfis merged commit cce5ecf into radius-project:v0.28 Jan 4, 2024
6 checks passed
Reshrahim added a commit that referenced this pull request Jan 18, 2024
* Uninstall docs

Signed-off-by: Reshma Abdul Rahim <[email protected]>

* Fix ref

Signed-off-by: Reshma Abdul Rahim <[email protected]>

* Apply suggestions from code review

Co-authored-by: Aaron Crawfis <[email protected]>
Signed-off-by: Reshma Abdul Rahim <[email protected]>

* Very small updates to Getting Started (#1015)

* Update index.md

small updates for clarity

Signed-off-by: Omer Bensaadon <[email protected]>

* Update docs/content/getting-started/index.md

Co-authored-by: Aaron Crawfis <[email protected]>
Signed-off-by: Omer Bensaadon <[email protected]>

* Update docs/content/getting-started/index.md

Co-authored-by: Aaron Crawfis <[email protected]>
Signed-off-by: Omer Bensaadon <[email protected]>

* Update docs/content/getting-started/index.md

Co-authored-by: Aaron Crawfis <[email protected]>
Signed-off-by: Omer Bensaadon <[email protected]>

* Update docs/content/getting-started/index.md

Signed-off-by: Omer Bensaadon <[email protected]>

---------

Signed-off-by: Omer Bensaadon <[email protected]>
Co-authored-by: Aaron Crawfis <[email protected]>

* Update docs/content/guides/operations/kubernetes/kubernetes-uninstall/index.md

Signed-off-by: Reshma Abdul Rahim <[email protected]>

* Merge v0.29

Signed-off-by: Reshma Abdul Rahim <[email protected]>

* Update docs/content/getting-started/index.md

Signed-off-by: Reshma Abdul Rahim <[email protected]>

* fix ref

Signed-off-by: Reshma Abdul Rahim <[email protected]>

* Fix ref

Signed-off-by: Reshma Abdul Rahim <[email protected]>

---------

Signed-off-by: Reshma Abdul Rahim <[email protected]>
Signed-off-by: Reshma Abdul Rahim <[email protected]>
Signed-off-by: Omer Bensaadon <[email protected]>
Co-authored-by: Aaron Crawfis <[email protected]>
Co-authored-by: Omer Bensaadon <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants