docs: openapi-generator README and rustdoc improvements (#4)

Upstream PR:

OpenAPITools/openapi-generator#10461

Author: PiDelport

twilio-oai-accounts-v1/README.md

@@ -2,21 +2,22 @@
 
 This is the public Twilio REST API.
 
+For more information, please visit [https://support.twilio.com](https://support.twilio.com)
+
 ## Overview
 
 This API client was generated by the [OpenAPI Generator](https://openapi-generator.tech) project.  By using the [openapi-spec](https://openapis.org) from a remote server, you can easily generate an API client.
 
 - API version: 1.20.3
 - Package version: 0.20.3
-- Build package: org.openapitools.codegen.languages.RustClientCodegen
-For more information, please visit [https://support.twilio.com](https://support.twilio.com)
+- Build package: `org.openapitools.codegen.languages.RustClientCodegen`
 
 ## Installation
 
 Put the package under your project folder and add the following to `Cargo.toml` under `[dependencies]`:
 
 ```
-    openapi = { path = "./generated" }
+twilio-oai-accounts-v1 = { path = "./generated" }
 ```
 
 ## Documentation

twilio-oai-accounts-v1/src/apis/default_api.rs

@@ -14,7 +14,7 @@ use reqwest;
 use crate::apis::ResponseContent;
 use super::{Error, configuration};
 
-/// struct for passing parameters to the method `create_credential_aws`
+/// struct for passing parameters to the method [`create_credential_aws`]
 #[derive(Clone, Debug, Default)]
 pub struct CreateCredentialAwsParams {
     /// A string that contains the AWS access credentials in the format `<AWS_ACCESS_KEY_ID>:<AWS_SECRET_ACCESS_KEY>`. For example, `AKIAIOSFODNN7EXAMPLE:wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY`
@@ -25,7 +25,7 @@ pub struct CreateCredentialAwsParams {
     pub friendly_name: Option<String>
 }
 
-/// struct for passing parameters to the method `create_credential_public_key`
+/// struct for passing parameters to the method [`create_credential_public_key`]
 #[derive(Clone, Debug, Default)]
 pub struct CreateCredentialPublicKeyParams {
     /// A URL encoded representation of the public key. For example, `-----BEGIN PUBLIC KEY-----MIIBIjANB.pa9xQIDAQAB-----END PUBLIC KEY-----`
@@ -36,49 +36,49 @@ pub struct CreateCredentialPublicKeyParams {
     pub friendly_name: Option<String>
 }
 
-/// struct for passing parameters to the method `delete_credential_aws`
+/// struct for passing parameters to the method [`delete_credential_aws`]
 #[derive(Clone, Debug, Default)]
 pub struct DeleteCredentialAwsParams {
     /// The Twilio-provided string that uniquely identifies the AWS resource to delete.
     pub sid: String
 }
 
-/// struct for passing parameters to the method `delete_credential_public_key`
+/// struct for passing parameters to the method [`delete_credential_public_key`]
 #[derive(Clone, Debug, Default)]
 pub struct DeleteCredentialPublicKeyParams {
     /// The Twilio-provided string that uniquely identifies the PublicKey resource to delete.
     pub sid: String
 }
 
-/// struct for passing parameters to the method `fetch_credential_aws`
+/// struct for passing parameters to the method [`fetch_credential_aws`]
 #[derive(Clone, Debug, Default)]
 pub struct FetchCredentialAwsParams {
     /// The Twilio-provided string that uniquely identifies the AWS resource to fetch.
     pub sid: String
 }
 
-/// struct for passing parameters to the method `fetch_credential_public_key`
+/// struct for passing parameters to the method [`fetch_credential_public_key`]
 #[derive(Clone, Debug, Default)]
 pub struct FetchCredentialPublicKeyParams {
     /// The Twilio-provided string that uniquely identifies the PublicKey resource to fetch.
     pub sid: String
 }
 
-/// struct for passing parameters to the method `list_credential_aws`
+/// struct for passing parameters to the method [`list_credential_aws`]
 #[derive(Clone, Debug, Default)]
 pub struct ListCredentialAwsParams {
     /// How many resources to return in each list page. The default is 50, and the maximum is 1000.
     pub page_size: Option<i32>
 }
 
-/// struct for passing parameters to the method `list_credential_public_key`
+/// struct for passing parameters to the method [`list_credential_public_key`]
 #[derive(Clone, Debug, Default)]
 pub struct ListCredentialPublicKeyParams {
     /// How many resources to return in each list page. The default is 50, and the maximum is 1000.
     pub page_size: Option<i32>
 }
 
-/// struct for passing parameters to the method `update_credential_aws`
+/// struct for passing parameters to the method [`update_credential_aws`]
 #[derive(Clone, Debug, Default)]
 pub struct UpdateCredentialAwsParams {
     /// The Twilio-provided string that uniquely identifies the AWS resource to update.
@@ -87,7 +87,7 @@ pub struct UpdateCredentialAwsParams {
     pub friendly_name: Option<String>
 }
 
-/// struct for passing parameters to the method `update_credential_public_key`
+/// struct for passing parameters to the method [`update_credential_public_key`]
 #[derive(Clone, Debug, Default)]
 pub struct UpdateCredentialPublicKeyParams {
     /// The Twilio-provided string that uniquely identifies the PublicKey resource to update.
@@ -97,195 +97,195 @@ pub struct UpdateCredentialPublicKeyParams {
 }
 
 
-/// struct for typed successes of method `create_credential_aws`
+/// struct for typed successes of method [`create_credential_aws`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum CreateCredentialAwsSuccess {
     Status201(crate::models::AccountsV1CredentialCredentialAws),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `create_credential_public_key`
+/// struct for typed successes of method [`create_credential_public_key`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum CreateCredentialPublicKeySuccess {
     Status201(crate::models::AccountsV1CredentialCredentialPublicKey),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `create_secondary_auth_token`
+/// struct for typed successes of method [`create_secondary_auth_token`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum CreateSecondaryAuthTokenSuccess {
     Status201(crate::models::AccountsV1SecondaryAuthToken),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `delete_credential_aws`
+/// struct for typed successes of method [`delete_credential_aws`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum DeleteCredentialAwsSuccess {
     Status204(),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `delete_credential_public_key`
+/// struct for typed successes of method [`delete_credential_public_key`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum DeleteCredentialPublicKeySuccess {
     Status204(),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `delete_secondary_auth_token`
+/// struct for typed successes of method [`delete_secondary_auth_token`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum DeleteSecondaryAuthTokenSuccess {
     Status204(),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `fetch_credential_aws`
+/// struct for typed successes of method [`fetch_credential_aws`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum FetchCredentialAwsSuccess {
     Status200(crate::models::AccountsV1CredentialCredentialAws),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `fetch_credential_public_key`
+/// struct for typed successes of method [`fetch_credential_public_key`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum FetchCredentialPublicKeySuccess {
     Status200(crate::models::AccountsV1CredentialCredentialPublicKey),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `list_credential_aws`
+/// struct for typed successes of method [`list_credential_aws`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum ListCredentialAwsSuccess {
     Status200(crate::models::ListCredentialAwsResponse),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `list_credential_public_key`
+/// struct for typed successes of method [`list_credential_public_key`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum ListCredentialPublicKeySuccess {
     Status200(crate::models::ListCredentialPublicKeyResponse),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `update_auth_token_promotion`
+/// struct for typed successes of method [`update_auth_token_promotion`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum UpdateAuthTokenPromotionSuccess {
     Status200(crate::models::AccountsV1AuthTokenPromotion),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `update_credential_aws`
+/// struct for typed successes of method [`update_credential_aws`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum UpdateCredentialAwsSuccess {
     Status200(crate::models::AccountsV1CredentialCredentialAws),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed successes of method `update_credential_public_key`
+/// struct for typed successes of method [`update_credential_public_key`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum UpdateCredentialPublicKeySuccess {
     Status200(crate::models::AccountsV1CredentialCredentialPublicKey),
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `create_credential_aws`
+/// struct for typed errors of method [`create_credential_aws`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum CreateCredentialAwsError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `create_credential_public_key`
+/// struct for typed errors of method [`create_credential_public_key`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum CreateCredentialPublicKeyError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `create_secondary_auth_token`
+/// struct for typed errors of method [`create_secondary_auth_token`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum CreateSecondaryAuthTokenError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `delete_credential_aws`
+/// struct for typed errors of method [`delete_credential_aws`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum DeleteCredentialAwsError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `delete_credential_public_key`
+/// struct for typed errors of method [`delete_credential_public_key`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum DeleteCredentialPublicKeyError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `delete_secondary_auth_token`
+/// struct for typed errors of method [`delete_secondary_auth_token`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum DeleteSecondaryAuthTokenError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `fetch_credential_aws`
+/// struct for typed errors of method [`fetch_credential_aws`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum FetchCredentialAwsError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `fetch_credential_public_key`
+/// struct for typed errors of method [`fetch_credential_public_key`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum FetchCredentialPublicKeyError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `list_credential_aws`
+/// struct for typed errors of method [`list_credential_aws`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum ListCredentialAwsError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `list_credential_public_key`
+/// struct for typed errors of method [`list_credential_public_key`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum ListCredentialPublicKeyError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `update_auth_token_promotion`
+/// struct for typed errors of method [`update_auth_token_promotion`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum UpdateAuthTokenPromotionError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `update_credential_aws`
+/// struct for typed errors of method [`update_credential_aws`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum UpdateCredentialAwsError {
     UnknownValue(serde_json::Value),
 }
 
-/// struct for typed errors of method `update_credential_public_key`
+/// struct for typed errors of method [`update_credential_public_key`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
 pub enum UpdateCredentialPublicKeyError {

twilio-oai-api-v2010/README.md

@@ -2,21 +2,22 @@
 
 This is the public Twilio REST API.
 
+For more information, please visit [https://support.twilio.com](https://support.twilio.com)
+
 ## Overview
 
 This API client was generated by the [OpenAPI Generator](https://openapi-generator.tech) project.  By using the [openapi-spec](https://openapis.org) from a remote server, you can easily generate an API client.
 
 - API version: 1.20.3
 - Package version: 0.20.3
-- Build package: org.openapitools.codegen.languages.RustClientCodegen
-For more information, please visit [https://support.twilio.com](https://support.twilio.com)
+- Build package: `org.openapitools.codegen.languages.RustClientCodegen`
 
 ## Installation
 
 Put the package under your project folder and add the following to `Cargo.toml` under `[dependencies]`:
 
 ```
-    openapi = { path = "./generated" }
+twilio-oai-api-v2010 = { path = "./generated" }
 ```
 
 ## Documentation