ServiceNow Service Graph Connector for Terraform - 1.0.0 GA documentation

[jastr945]

To be merged when the Service Graph Connector for Terraform goes GA on July 26th.

Website preview: https://terraform-docs-common-kk1pbxo4m-hashicorp.vercel.app/terraform/cloud-docs/integrations/service-now/service-graph

What

A new integration between TFC/E and ServiceNow - the Service Graph Connector for Terraform - goes live on July 26th. This PR adds a new section to Terraform Cloud > Integrations > ServiceNow Integrations > Service Graph Connector for Terraform. The new section contains 4 child pages documenting the setup and various parts of the new application.

The menu hierarchy has changed. The previous "ServiceNow Integration" section contains documentation about our existing app - the Service Catalog for Terraform. Now that we have the 2nd app, both of them will be located under Terraform Cloud > Integrations > ServiceNow Integrations. Redirects are part of this PR.

This PR should be merged on the go-live date - July 26th.

A few notes:

• there are at least 2 "TODO" elements left in this PR that need to be filled once the app is published in the ServiceNow Store (screenshots and links);
• the "Resource Coverage" page contains a lot of tables. I really don't like how it looks and would appreciate any advice on making it more user-friendly.

There is a related PR to update the previously published tutorial for the Service Graph Connector for Terraform. A few GA-related updates have been made to the tutorial. We also plan to merge them on July 26th: https://github.com/hashicorp/tutorials/pull/1381

The PR also contains an app version update for the Service Catalog, as v2.2.1 has just been released on July 24th.

Why

Technical documentation of the brand new application needs to be provided to end users.

---

Merge Checklist

If items do not apply to your changes, add (N/A) and mark them as complete.

Pull Request

• One or more labels describe the type of change (e.g. clarification) and associated product (e.g. tfc).
• Description links to related pull requests or issues, if any.

Content

• Redirects have been added for moved, renamed, or deleted pages. This requires a separate PR in the terraform-website repository redirects.next.js file. Redirects are now part of this repo and this PR.
• N/A API documentation and the API Changelog have been updated.
• Links to related content where appropriate (e.g., API endpoints, permissions, etc.).
• Pages with related content are updated and link to this content when appropriate.
• Sidebar navigation files have been updated for added, deleted, reordered, or renamed pages.
• New pages have metadata (page name and description) at the top.
• New images are 2048 px wide. They have HashiCorp standard annotation color (#F92672) and format (rectangle with rounded corners), blurred sensitive details (e.g. credentials, usernames, user icons), and descriptive alt text in the markdown for accessibility.
• N/A (no code blocks). New code blocks have the correct syntax and line breaks to eliminate horizontal scroll bars.
• UI elements (button names, page names, etc.) are bolded.
• The Vercel website preview successfully deployed.

Reviews

• I or someone else reviewed the content for technical accuracy.
• I or someone else reviewed the content for typos, punctuation, spelling, and grammar.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
terraform-docs-common	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 26, 2023 2:22pm

[iBrandyJackson]

one small edit around naming to include 'connector' - otherwise looks good to me!

[judithpatudith]

Would we want to break this up and make separate pages for each cloud provider? It might future proof the pages a little too as more resources come along

[jastr945]

I like this idea. Will do!

[judithpatudith]

Would we want to put this above the tables so it doesn't get lost in the scroll?

[jastr945]

Once I transferred the provider tables into their own separate child pages, the overview page got much nicer and shorter and no longer requires scrolling.