Update IAM SAML Federation documentation (#299)

website/docs/r/iam_saml_federation_certificate_v1.html.markdown

@@ -26,23 +26,23 @@ resource "selectel_iam_saml_federation_certificate_v1" "certificate" {
 
 ## Argument Reference
 
-* `federation_id` - (Required) Federation ID.
+* `federation_id` - (Required) Unique identifier of the federation.
 
 * `name` - (Required) Certificate name.
 
 * `description` - (Optional) Certificate description.
 
-* `data` - (Required) Certificate data.  It must begin with -----BEGIN CERTIFICATE----- and end with -----END CERTIFICATE-----.
+* `data` - (Required) Certificate data. Must begin with `-----BEGIN CERTIFICATE-----` and end with `-----END CERTIFICATE-----`.
 
 ## Attributes Reference
 
-* `account_id` - Federation account ID.
+* `account_id` - Selectel account ID. The account ID is in the top right corner of the [Control panel](https://my.selectel.ru/). Learn more about [Registration](https://docs.selectel.ru/en/control-panel-actions/account/registration/).
 
-* `not_before` - Issuing date.
+* `not_before` - Issue date of the certificate.
 
-* `not_after` - End date.
+* `not_after` - Expiration date of the certificate.
 
-* `fingerprint` - Fingerprint.
+* `fingerprint` - Fingerprint of the certificate.
 
 ## Import
 
@@ -64,6 +64,6 @@ where:
 
 * `<password>` — Password of the service user.
 
-* `<federtaion_id>` — Unique identifier of the Federation, which has this certificate, for example, `abc1bb378ac84e1234b869b77aadd2ab`. To get the federation ID, use either [Control Panel](https://my.selectel.ru/iam/federations) or [IAM API](https://developers.selectel.ru/docs/control-panel/iam/)
+* `<federation_id>` — Unique identifier of the associated federation, for which the certificate is issued, for example, `abc1bb378ac84e1234b869b77aadd2ab`. To get the federation ID, use either [Control Panel](https://my.selectel.ru/iam/federations) or [IAM API](https://developers.selectel.ru/docs/control-panel/iam/).
 
-* `<certificate_id>` — Unique identifier of the Certificate.
+* `<certificate_id>` — Unique identifier of the certificate.

website/docs/r/iam_saml_federation_v1.html.markdown

@@ -10,7 +10,7 @@ description: |-
 
 Manages SAML Federation for Selectel products using public API v1.
 Selectel products support Identity and Access Management (IAM).
-For more information about Federations, see the [official Selectel documentation](https://docs.selectel.ru/en/control-panel-actions/users-and-roles/federations/).
+For more information about federations, see the [official Selectel documentation](https://docs.selectel.ru/en/control-panel-actions/users-and-roles/federations/).
 
 ## Example Usage
 
@@ -30,19 +30,19 @@ resource "selectel_iam_saml_federation_v1" "federation_1" {
 
 * `description` - (Optional) Federation description.
 
-* `issuer` - (Required) ID of the credential provider.
+* `issuer` - (Required) Identifier of the credential provider.
 
 * `sso_url` - (Required) Link to the credential provider login page.
 
-* `sign_authn_requests` - (Optional) Enable authentication requests signing.
+* `sign_authn_requests` - (Optional) Enables signing of authentication requests.
 
-* `force_authn` - (Optional) Require users to authenticate via SSO every time they log in.
+* `force_authn` - (Optional) Requires users to authenticate via SSO every time they log in.
 
 * `session_max_age_hours` - (Required) Session lifetime.
 
 ## Attributes Reference
 
-* `account_id` - Federation account ID.
+* `account_id` - Selectel account ID. The account ID is in the top right corner of the [Control panel](https://my.selectel.ru/). Learn more about [Registration](https://docs.selectel.ru/control-panel-actions/account/registration/).
 
 ## Import