Skip to content
This repository has been archived by the owner on Jan 30, 2023. It is now read-only.

Create setting-policies-for-an-app.md #630

Open
wants to merge 6 commits into
base: master
Choose a base branch
from

Conversation

carolinamenezes
Copy link
Collaborator

What problem is this solving?

How should this be manually tested?

Screenshots or example usage:

@vtex-io-ci-cd
Copy link

vtex-io-ci-cd bot commented Jun 26, 2020

Hi! I'm VTEX IO CI/CD Bot and I'll be helping you to publish your app! 🤖

Please select which version do you want to release:

  • Patch (backwards-compatible bug fixes)

  • Minor (backwards-compatible functionality)

  • Major (incompatible API changes)

And then you just need to merge your PR when you are ready! There is no need to create a release commit/tag.

  • No thanks, I would rather do it manually 😞

- a `name`, which is a unique identifier of a given policy.
- a `reason`, which may briefly describe the policy.

>:warning: **Keep in mind:** The `reason` may aid the person who wants to install the app in taking the decision of installing it or not.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Remember to use the div disclaimer

docs/en/Recipes/development/setting-policies-for-an-app.md Outdated Show resolved Hide resolved

### Referencing a set of policies

We also allow an app to export a `policies.json` file, containing a given set of policies. To reference one of those in your app manifest, you may set the `name` value as the app name that declared the `policies.json` followed by the policy name, as in `{account}.{app-name}@{version}:{policy-name}`.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
We also allow an app to export a `policies.json` file, containing a given set of policies. To reference one of those in your app manifest, you may set the `name` value as the app name that declared the `policies.json` followed by the policy name, as in `{account}.{app-name}@{version}:{policy-name}`.
We also allow an app to export a `policies.json` file, containing a given set of policies.
To reference one of those in your app manifest, you may set the `name` value as the app name that declared the `policies.json` followed by the policy name, as in `{account}.{app-name}@{version}:{policy-name}`.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Acho que vale esclarecer mais quando usar um e quando usar outro. Tipo, quando eu crio um arquivo e quando não? Quando é vantajoso, sabe? Isso pode ficar mais explícito. O que acha?

Além disso, acho que podemos mastigar mais como esse file deve ser estruturado, digo, como deve ser a estrutura desse artigo? Parece que engolimos um passo, que é o de montar o artigo, e fomos para como referenciá-lo.


Notice that `catalog-proxy` is the `name` of a policy previously declared in a `policies.json` file of the `app-name` app.

## Modus Operandis
Copy link
Collaborator

Choose a reason for hiding this comment

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

A gente pode ou não usar essas seções em recipes/tutoriais. Faz mais sentido usar em documentações de app, quando queremos explicar como a app tal funciona. No caso da recipe, ela em si já explica o Modus Operandi, então podemos omitir.

docs/en/Recipes/development/setting-policies-for-an-app.md Outdated Show resolved Hide resolved
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants