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

feat: Update docs about recent changes related to kyma-dashboard #3347

Merged
merged 12 commits into from
Sep 18, 2024

Conversation

dbadura
Copy link
Contributor

@dbadura dbadura commented Sep 16, 2024

Description

Changes proposed in this pull request:

  • Adjust docs to new configuration management

Related issue(s)
#3298

Definition of done

  • The PR's title starts with one of the following prefixes:
    • feat: A new feature
    • fix: A bug fix
    • docs: Documentation only changes
    • refactor: A code change that neither fixes a bug nor adds a feature
    • test: Adding tests
    • chore: Maintainance changes to the build process or auxiliary tools, libraries, workflows, etc.
  • Related issues are linked. To link internal trackers, use the issue IDs like backlog#4567
  • Explain clearly why you created the PR and what changes it introduces
  • All necessary steps are delivered, for example, tests, documentation, merging

@kyma-bot kyma-bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Sep 16, 2024
@kyma-bot
Copy link
Contributor

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@kyma-bot kyma-bot added the cla: yes Indicates the PR's author has signed the CLA. label Sep 16, 2024
@dbadura dbadura mentioned this pull request Sep 16, 2024
11 tasks
@kyma-bot kyma-bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Sep 16, 2024
@dbadura dbadura marked this pull request as ready for review September 16, 2024 13:11
@kyma-bot kyma-bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Sep 16, 2024
kyma/README.md Outdated
Comment on lines 1 to 9
> **NOTE:** This is a general template that you can use for a project README.md. Except for the mandatory sections, use only those sections that suit your use case but keep the proposed section order.
>
> Mandatory sections:
> - `Overview`
> - `Prerequisites`, if there are any requirements regarding hard- or software
> - `Installation`
> - `Contributing` - do not change this!
> - `Code of Conduct` - do not change this!
> - `Licensing` - do not change this!
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
> **NOTE:** This is a general template that you can use for a project README.md. Except for the mandatory sections, use only those sections that suit your use case but keep the proposed section order.
>
> Mandatory sections:
> - `Overview`
> - `Prerequisites`, if there are any requirements regarding hard- or software
> - `Installation`
> - `Contributing` - do not change this!
> - `Code of Conduct` - do not change this!
> - `Licensing` - do not change this!

kyma/README.md Outdated
Comment on lines 48 to 49
- [`npm`](https://www.npmjs.com/) in version 8.1.2 or higher
- [`node`](https://nodejs.org/en/) in version 16.13.2 or higher
Copy link
Contributor

Choose a reason for hiding this comment

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

Here we should have the same versions as for busola

@kyma-bot kyma-bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Sep 17, 2024
mrCherry97
mrCherry97 previously approved these changes Sep 17, 2024
@kyma-bot kyma-bot added the lgtm Looks good to me! label Sep 17, 2024
README.md Outdated Show resolved Hide resolved
kyma/README.md Outdated Show resolved Hide resolved
kyma/README.md Outdated Show resolved Hide resolved
kyma/README.md Outdated Show resolved Hide resolved
kyma/README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated
When the `ENVIRONMENT` is set to `my-env`, the busola looks for custom configuration in **public/environemnt/my-env**
If the `ENVIRONMENT` is not set busola fetch default configuration which has the same structure as custom configuration located in [public](./public)

In case of docker image, the file `active.env` is created from `ENVIRONMENT` env at the startup to image.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
In case of docker image, the file `active.env` is created from `ENVIRONMENT` env at the startup to image.
In the case of the Docker image, the `active.env` file is created from the **ENVIRONMENT** env at the startup of the image.

Copy link
Contributor

Choose a reason for hiding this comment

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

Again, I'm not sure if I understand it correctly. What is "env" here? If it's environment, is it necessary to say "ENVIRONMENT 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.

env is a shortcut of environment variable which is represented by KEY=value, so to make it more readable I used env. Additionaly it's quite common to name it like that.

Copy link
Contributor

Choose a reason for hiding this comment

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

If it's not the actual value, I recommend rephrasing it to:
In the case of the Docker image, the active.env file is created at the startup of the image from the environment specified in the ENVIRONMENT variable.

@kyma-bot kyma-bot removed the lgtm Looks good to me! label Sep 17, 2024
@kyma-bot kyma-bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Sep 18, 2024
kyma/README.md Outdated Show resolved Hide resolved
Co-authored-by: Iwona Langer <[email protected]>
@kyma-bot kyma-bot added the lgtm Looks good to me! label Sep 18, 2024
@mrCherry97
Copy link
Contributor

/override tide

@kyma-bot
Copy link
Contributor

@mrCherry97: Overrode contexts on behalf of mrCherry97: tide

In response to this:

/override tide

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@mrCherry97 mrCherry97 merged commit d69e5f7 into kyma-project:main Sep 18, 2024
15 checks passed
@dbadura dbadura deleted the update-docs branch September 18, 2024 12:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cla: yes Indicates the PR's author has signed the CLA. lgtm Looks good to me! size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants