Terraform GitHub Actions updates

[sudomateo]

Updated to reflect YAML syntax
Reorganized content layout

[sudomateo]

I meant to make this a draft pull request. I still have a few updates I would like to make.

[sudomateo]

This is ready for review.

[nfagerlund]

This is an impressive rewrite; thank you for it!

There are a few things inline that I think need adjustments. There are also two structural things that need a bit more iteration:

Sections

The name of the "Configuration" section makes sense. But the "Workflows" section is confusing, because it collides with the local term of art, where in GitHub Actions a "workflow" is a YAML file that sets up a chain of actions. Consequently, the "Workflows" section doesn't contain what I'd expect it to, after reading the front page and the main configuration page:

In a different context, I could get down with "workflows" being the correct name for what we're dealing with here, but locally I think we have to call it something different. Spitballing here:

• How-To
• Customization
• Common Tasks

...but I'm open to other suggestions.

If you don't want to wrestle with this one alone, we can jam about it in the #proj-tf-docs channel or something.

Redirects

This changes a bunch of URLs! Before we ship it, we've gotta get the appropriate redirects into content/redirects.txt.

That should probably wait until we sort out what to do about the workflows directory.

[sudomateo]

Updated with changes based on your feedback. I went with the name "Common Actions" instead of "Workflows". I'm open to changing it if needed.

I also updated content/redirects.txt to redirect all of the changed URLs to their new location.

[sudomateo]

The TravisCI build is complaining about missing links.

http://127.0.0.1:4567/docs/providers/azurerm/auth/azure_cli.html:
Remote file does not exist -- broken link!!!
http://127.0.0.1:4567/docs/providers/azurerm/auth/managed_service_identity.html:
Remote file does not exist -- broken link!!!
http://127.0.0.1:4567/docs/providers/azurerm/auth/service_principal_client_secret.html:
Remote file does not exist -- broken link!!!

Seems like these links are now located at the following places respectively.

/docs/providers/azurerm/guides/azure_cli.html
/docs/providers/azurerm/guides/managed_service_identity.html
/docs/providers/azurerm/auth/service_principal_client_secret.html

[nfagerlund]

Looking into those azure things right now, I think I found the issue.

[nfagerlund]

For any spectators: we caught up in Slack and are gonna change it to "Common Tasks."

Here's one or two more small items I noticed — ping me once you're done, and I'll do a last check to make sure all the links line up, and then we can

[nfagerlund]

Thanks again for all your work on this! Tweaked the thing about outputs to reference user-level docs, and added an example. And with that, I think we're done.