Skip to content

Peering Container documentation fix #193

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

Merged
merged 1 commit into from
Apr 14, 2020
Merged

Conversation

themantissa
Copy link
Collaborator

Upstream Atlas API docs incorrect described these parameters. Fixing here and submitted a bug report upstream. Examples in both, however, are correct.

Upstream Atlas API docs incorrect described these parameters.  Fixing here and submitted a bug report upstream.  Examples in both, however, are correct.
Copy link
Collaborator

@shum shum left a comment

Choose a reason for hiding this comment

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

Small alternative wording proposal

@@ -47,8 +47,8 @@ In addition to all arguments above, the following attributes are exported:
* `id` - The Network Peering Container ID.
* `atlas_cidr_block` - CIDR block that Atlas uses for your clusters. Atlas uses the specified CIDR block for all other Network Peering connections created in the project. The Atlas CIDR block must be at least a /24 and at most a /21 in one of the following [private networks](https://tools.ietf.org/html/rfc1918.html#section-3).
* `provider_name` - Cloud provider for this Network Peering connection. If omitted, Atlas sets this parameter to AWS.
* `region_name` - AWS region.
* `region` - Azure region where the container resides.
* `region_name` - The Atlas AWS region name for where this container will exist.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Wondering if the modifier should go be placed on the container rather than the region name, such as:

Suggested change
* `region_name` - The Atlas AWS region name for where this container will exist.
* `region_name` - The AWS region name for where this Atlas container will exist.

or

Suggested change
* `region_name` - The Atlas AWS region name for where this container will exist.
* `region_name` - The AWS region name for where Atlas' network peering container will exist.

Since I'm not sure what the original confusion was caused by, also fine with "the Atlas AWS/Azure region name" pattern.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

So the actual Atlas doc is wrong, it's the Atlas region name that is needed, not the AWS region name. The examples are right the main Atlas API docs but not the text (DOCSP-9914 for fix) so was trying to clarify here as we had someone trying to use the AWS region name, which is slightly different, so it failed. Make more sense now?

Copy link
Collaborator

@shum shum Apr 14, 2020

Choose a reason for hiding this comment

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

Oh got it, then your original suggestion is correct. "Atlas AWS/Azure region name" is a bit of a mouthful but I don't think we have anything better available.

LGTM.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

That's why I was open to suggestions - it's awkward to phrase. If docs had a better way I'll update this then. Thanks for the feedback/discussion!

@themantissa themantissa merged commit f533fcb into master Apr 14, 2020
@themantissa themantissa deleted the minor-doc-update-peering branch April 22, 2020 17:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants