chore: Add migration notes to the docs and change jira integration (#…

…2497)

- better jira integration
- migration guide added to the official docs

.github/workflows/team-jira-issues.yml

@@ -16,23 +16,27 @@ jobs:
           --header 'Content-Type: application/json' \
           --data-raw '{
               "fields": {
-                "project":
-                {
-                    "key": "${{ secrets.JIRA_PROJECT }}"
+                "project": {
+                  "key": "${{ secrets.JIRA_PROJECT }}"
                 },
                 "summary": "terraform-provider-snowflake issue ${{ github.event.issue.number }}",
-                "description": "${{ github.event.issue.html_url }}",
+                "description": "*Title*\n${{ github.event.issue.title }}\n\n*URL*\n${{ github.event.issue.html_url }}\n\n*Body*\n${{ github.event.issue.body }}",
                 "issuetype": {
-                    "name": "Story"
+                  "name": "Task"
                 },       
-                "components": [{
-                "id": "${{ secrets.JIRA_COMPONENT }}"
-              }],
-                "labels": ["${{ secrets.JIRA_LABEL }}"],
-                "customfield_11401": {"id": "${{ secrets.JIRA_AREA }}"},
+                "components": [
+                  {
+                    "id": "${{ secrets.JIRA_COMPONENT }}"
+                  }
+                ],
+                "labels": [${{ secrets.JIRA_LABELS }}],
+                "customfield_11401": {
+                  "id": "${{ secrets.JIRA_AREA }}"
+                },
                 "customfield_10008": "${{ secrets.JIRA_EPIC }}",
-                "assignee": {"id": "${{ secrets.JIRA_ASSIGNEE }}"},
-                "reporter": {"id": "${{ secrets.JIRA_ASSIGNEE }}"}
+                "assignee": {
+                  "id": "${{ secrets.JIRA_ASSIGNEE }}"
+                }
               }
             }
           }'

docs/index.md

@@ -7,6 +7,8 @@ description: Manage SnowflakeDB with Terraform.
 
 ~> **Disclaimer** the project is still in the 0.x.x version, which means it’s still in the experimental phase (check [Go module versioning](https://go.dev/doc/modules/version-numbers#v0-number) for more details). It can be used in production but makes no stability or backward compatibility guarantees. We do not provide backward bug fixes and, therefore, always suggest using the newest version. We are providing only limited support for the provider; priorities will be assigned on a case-by-case basis. Our main current goals are stabilization, addressing existing issues, and providing the missing features (prioritizing the GA features; supporting PrPr and PuPr features are not high priorities now). With all that in mind, we aim to reach V1 with a stable, reliable, and functional provider. V1 will be free of all the above limitations.
 
+-> **Note** Please check the [migration guide](https://github.com/Snowflake-Labs/terraform-provider-snowflake/blob/main/MIGRATION_GUIDE.md) when changing the version of the provider.
+
 -> **Note** the current roadmap is available in our GitHub repository: [ROADMAP.md](https://github.com/Snowflake-Labs/terraform-provider-snowflake/blob/main/ROADMAP.md).
 
 This is a terraform provider plugin for managing [Snowflake](https://www.snowflake.com/) accounts.

templates/index.md.tmpl

@@ -7,6 +7,8 @@ description: Manage SnowflakeDB with Terraform.
 
 ~> **Disclaimer** the project is still in the 0.x.x version, which means it’s still in the experimental phase (check [Go module versioning](https://go.dev/doc/modules/version-numbers#v0-number) for more details). It can be used in production but makes no stability or backward compatibility guarantees. We do not provide backward bug fixes and, therefore, always suggest using the newest version. We are providing only limited support for the provider; priorities will be assigned on a case-by-case basis. Our main current goals are stabilization, addressing existing issues, and providing the missing features (prioritizing the GA features; supporting PrPr and PuPr features are not high priorities now). With all that in mind, we aim to reach V1 with a stable, reliable, and functional provider. V1 will be free of all the above limitations.
 
+-> **Note** Please check the [migration guide](https://github.com/Snowflake-Labs/terraform-provider-snowflake/blob/main/MIGRATION_GUIDE.md) when changing the version of the provider.
+
 -> **Note** the current roadmap is available in our GitHub repository: [ROADMAP.md](https://github.com/Snowflake-Labs/terraform-provider-snowflake/blob/main/ROADMAP.md).
 
 This is a terraform provider plugin for managing [Snowflake](https://www.snowflake.com/) accounts.