-
Notifications
You must be signed in to change notification settings - Fork 3
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
base: main
Are you sure you want to change the base?
Conversation
🌟 EkLine ReviewerHello! 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]. |
There was a problem hiding this 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)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 51 in 4e60db2
- All properties can be changed |
🚫 [EkLine] reported by reviewdog 🐶
'Snap Kit Actions' should use sentence-style capitalization. (EK00037)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 53 in 4e60db2
## Snap Kit Actions |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 54 in 4e60db2
- Can be removed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 57 in 4e60db2
- Function can be changed |
🚫 [EkLine] reported by reviewdog 🐶
'Snap Components' should use sentence-style capitalization. (EK00037)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 59 in 4e60db2
## Snap Components |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 60 in 4e60db2
- Can be removed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 63 in 4e60db2
- Description can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 64 in 4e60db2
- Surface cannot be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 65 in 4e60db2
- Snap kit action name can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 66 in 4e60db2
- Snap kit body can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 67 in 4e60db2
- Initializer can be changed |
🚫 [EkLine] reported by reviewdog 🐶
'Service Account' should use sentence-style capitalization. (EK00037)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 69 in 4e60db2
## Service Account |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 70 in 4e60db2
- Display name can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 71 in 4e60db2
- Description can be changed |
🚫 [EkLine] reported by reviewdog 🐶
'Inputs (Global Variables)' should use sentence-style capitalization. (EK00037)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 73 in 4e60db2
## Inputs (Global Variables) |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 74 in 4e60db2
- Can be added or removed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 77 in 4e60db2
- All other properties can be modified |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 80 in 4e60db2
- New imports can be added |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 81 in 4e60db2
- Existing imports cannot be removed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 84 in 4e60db2
- Description can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 85 in 4e60db2
- Function cannot be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 86 in 4e60db2
- New allowed keyring types can be added |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 87 in 4e60db2
- Existing allowed keyring types cannot be removed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 88 in 4e60db2
- Function name can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 89 in 4e60db2
- Loader function cannot be removed once set |
🚫 [EkLine] reported by reviewdog 🐶
'User Level Keyrings' should use sentence-style capitalization. (EK00037)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 91 in 4e60db2
## User Level Keyrings |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 92 in 4e60db2
- New keyrings can be added |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 93 in 4e60db2
- Existing keyrings can be removed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 96 in 4e60db2
- Display name can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 97 in 4e60db2
- New allowed types can be added |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 98 in 4e60db2
- Existing allowed types cannot be removed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 99 in 4e60db2
- Required keyrings can be made optional |
🚫 [EkLine] reported by reviewdog 🐶
'User Level Inputs' should use sentence-style capitalization. (EK00037)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 101 in 4e60db2
## User Level Inputs |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 102 in 4e60db2
- Can be added or removed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 105 in 4e60db2
- All other properties can be modified |
🚫 [EkLine] reported by reviewdog 🐶
'Keyring Types' should use sentence-style capitalization. (EK00037)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 107 in 4e60db2
## Keyring Types |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 108 in 4e60db2
- Can be added or removed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 111 in 4e60db2
- Description can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 112 in 4e60db2
- Scopes can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 113 in 4e60db2
- Scope delimiter can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 114 in 4e60db2
- 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)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 115 in 4e60db2
- Organization data can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 116 in 4e60db2
- External service name can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 117 in 4e60db2
- Kind cannot be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 118 in 4e60db2
- Keyring type template cannot be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 119 in 4e60db2
- OAuth secret ID cannot be changed |
🚫 [EkLine] reported by reviewdog 🐶
'Functions Build Config' should use sentence-style capitalization. (EK00037)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 121 in 4e60db2
## Functions Build Config |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 122 in 4e60db2
- 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)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 123 in 4e60db2
- All properties can be changed |
🚫 [EkLine] reported by reviewdog 🐶
'Configuration Handler' should use sentence-style capitalization. (EK00037)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 125 in 4e60db2
## Configuration Handler |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 126 in 4e60db2
- 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)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 127 in 4e60db2
- All properties can be changed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 130 in 4e60db2
- New operations can be added |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 131 in 4e60db2
- Existing operations cannot be removed |
🚫 [EkLine] reported by reviewdog 🐶
Must put the ending punctuation at the end of a list item. (EK00041)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 134 in 4e60db2
- 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)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 135 in 4e60db2
- 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)
fern-api-docs/fern/docs/pages/references/snap-in-version-upgrade-compatibility.mdx
Line 136 in 4e60db2
- Keyring types follow the same rules as Connections |
- Optional connections cannot be made required | ||
- Required connections can be made optional | ||
|
||
## Event Sources |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Published docs preview URL: https://devrev-preview-ed4bcbd6-fe7a-4023-b558-d28107a84148.docs.buildwithfern.com |
- 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). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Full flexibility - can be added, removed, or modified. | ||
- All properties can be changed. | ||
|
||
## Snap Kit Actions |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- All properties can be changed. | ||
|
||
## Snap Kit Actions | ||
- Can be removed |
There was a problem hiding this comment.
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)
- Can be removed | |
- Can be removed. |
- Description can be changed. | ||
- Function can be changed. | ||
|
||
## Snap Components |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Function can be changed. | ||
|
||
## Snap Components | ||
- Can be removed |
There was a problem hiding this comment.
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)
- Can be removed | |
- Can be removed. |
- Function name can be changed. | ||
- Loader function cannot be removed once set. | ||
|
||
## User Level Keyrings |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Existing allowed types cannot be removed. | ||
- Required keyrings can be made optional. | ||
|
||
## User Level Inputs |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Type cannot be changed. | ||
- All other properties can be modified. | ||
|
||
## Keyring Types |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Keyring type template cannot be changed. | ||
- OAuth secret ID cannot be changed. | ||
|
||
## Functions Build Config |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Full flexibility - can be added, removed, or modified. | ||
- All properties can be changed. | ||
|
||
## Configuration Handler |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Published docs preview URL: https://devrev-preview-943d84de-192c-4d91-b468-0ed1cb004513.docs.buildwithfern.com |
- New keyring types can be added. | ||
- Existing keyring types cannot be removed. |
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
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: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@SathishKumarHS Please check
There was a problem hiding this comment.
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 |
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
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. |
There was a problem hiding this comment.
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
There was a problem hiding this 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
@altafDevRev please either complete this PR or close it. |
No description provided.