Skip to content

chore: add snap-in version upgrade compatibility doc #147

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

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

altafDevRev
Copy link
Contributor

No description provided.

@altafDevRev altafDevRev requested a review from a team as a code owner January 30, 2025 08:48
Copy link
Contributor

github-actions bot commented Jan 30, 2025

🌟 EkLine Reviewer

Hello! I’m here to help improve your docs. I’ve reviewed your pull request, and left in-line suggestions for quick fixes. For details, visit the Analytics Page.

For questions or feedback, please email [email protected].

Copy link
Contributor

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

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

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

EkLine

🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

'Snap Kit Actions' should use sentence-style capitalization. (EK00037)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

'Snap Components' should use sentence-style capitalization. (EK00037)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

'Service Account' should use sentence-style capitalization. (EK00037)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

'Inputs (Global Variables)' should use sentence-style capitalization. (EK00037)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)

- Existing allowed keyring types cannot be removed


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

'User Level Keyrings' should use sentence-style capitalization. (EK00037)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

'User Level Inputs' should use sentence-style capitalization. (EK00037)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

'Keyring Types' should use sentence-style capitalization. (EK00037)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)

- Authorize, refresh, and revoke functions can be changed


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

'Functions Build Config' should use sentence-style capitalization. (EK00037)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)

- Full flexibility - can be added, removed, or modified


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

'Configuration Handler' should use sentence-style capitalization. (EK00037)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)

- Full flexibility - can be added, removed, or modified


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)

- Input ports cannot be changed (including type and schema)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)

- Output ports cannot be changed (including type and schema)


🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)

- Keyring types follow the same rules as Connections

- Optional connections cannot be made required
- Required connections can be made optional

## Event Sources
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [EkLine] reported by reviewdog 🐶

'Event Sources' should use sentence-style capitalization. (EK00037)

Copy link
Contributor

- Display name can be changed.
- Type cannot be changed.
- Connection can be removed but cannot be changed.
- Source config can be changed (test changes thoroughly).
Copy link
Contributor

Choose a reason for hiding this comment

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

📝 [EkLine] reported by reviewdog 🐶

Remove 'thoroughly' if it's not important to the meaning of the statement. (EK00006)

Suggested change
- Source config can be changed (test changes thoroughly).
- Source config can be changed (test changes).

- Full flexibility - can be added, removed, or modified.
- All properties can be changed.

## Snap Kit Actions
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [EkLine] reported by reviewdog 🐶

'Snap Kit Actions' should use sentence-style capitalization. (EK00037)

- All properties can be changed.

## Snap Kit Actions
- Can be removed
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)

Suggested change
- Can be removed
- Can be removed.

- Description can be changed.
- Function can be changed.

## Snap Components
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [EkLine] reported by reviewdog 🐶

'Snap Components' should use sentence-style capitalization. (EK00037)

- Function can be changed.

## Snap Components
- Can be removed
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [EkLine] reported by reviewdog 🐶

Must put the ending punctuation at the end of a list item. (EK00041)

Suggested change
- Can be removed
- Can be removed.

- Function name can be changed.
- Loader function cannot be removed once set.

## User Level Keyrings
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [EkLine] reported by reviewdog 🐶

'User Level Keyrings' should use sentence-style capitalization. (EK00037)

- Existing allowed types cannot be removed.
- Required keyrings can be made optional.

## User Level Inputs
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [EkLine] reported by reviewdog 🐶

'User Level Inputs' should use sentence-style capitalization. (EK00037)

- Type cannot be changed.
- All other properties can be modified.

## Keyring Types
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [EkLine] reported by reviewdog 🐶

'Keyring Types' should use sentence-style capitalization. (EK00037)

- Keyring type template cannot be changed.
- OAuth secret ID cannot be changed.

## Functions Build Config
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [EkLine] reported by reviewdog 🐶

'Functions Build Config' should use sentence-style capitalization. (EK00037)

- Full flexibility - can be added, removed, or modified.
- All properties can be changed.

## Configuration Handler
Copy link
Contributor

Choose a reason for hiding this comment

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

🚫 [EkLine] reported by reviewdog 🐶

'Configuration Handler' should use sentence-style capitalization. (EK00037)

Copy link
Contributor

Comment on lines +10 to +11
- New keyring types can be added.
- Existing keyring types cannot be removed.
Copy link
Contributor

Choose a reason for hiding this comment

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

Let's rename it to allowed_connection_types or what is present in the manifest. Keyring Types have a different meaning

- Required connections can be made optional.

## Event Sources
- New event sources cannot be added.
Copy link
Contributor

Choose a reason for hiding this comment

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

We can add new event sources

- Loader function cannot be removed once set.

## User Level Keyrings
- New keyrings can be added.
Copy link
Contributor

Choose a reason for hiding this comment

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

We don't allow required user level keyrings


## Keyring Types
- Can be added or removed.
- For existing keyring types:
Copy link
Contributor

Choose a reason for hiding this comment

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

@SathishKumarHS Please check

Copy link
Contributor

Choose a reason for hiding this comment

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

  • scope delimiter cannot be changed
  • lets add one more, secret_config cannot be changed

- Keyring type template cannot be changed.
- OAuth secret ID cannot be changed.

## Functions Build Config
Copy link
Contributor

Choose a reason for hiding this comment

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

Remove this section. Build config is not documented

- For existing imports:
- Display name can be changed.
- Description can be changed.
- Function cannot be changed.
Copy link
Contributor

Choose a reason for hiding this comment

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

function can be changed

- Function cannot be changed.
- New allowed keyring types can be added.
- Existing allowed keyring types cannot be removed.
- Function name can be changed.
Copy link
Contributor

Choose a reason for hiding this comment

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

Looks repeated


## Service Account
- Display name can be changed.
- Description can be changed.
Copy link
Contributor

Choose a reason for hiding this comment

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

We cannot set description from the manifest

Copy link
Contributor

@navneel99 navneel99 left a comment

Choose a reason for hiding this comment

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

Let's also add that there is no notion for rename. Only Delete and Add.
If someone is renaming event_sources, inputs etc. They will be deleting it and a new one will get created. This will cause loss of values set in the org.

Better way will be to just update the ui.display_name instead

@bc-devrev
Copy link
Contributor

@altafDevRev please either complete this PR or close it.

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.

5 participants