docs(events): Add some comments so rustdoc is slightly more helpful

Author: LegNeato

aws_lambda_events/src/generated/mod.rs

@@ -1,18 +1,36 @@
+/// AWS Lambda event definitions for apigw.
 pub mod apigw;
+/// AWS Lambda event definitions for appsync.
 pub mod appsync;
+/// AWS Lambda event definitions for autoscaling.
 pub mod autoscaling;
+/// AWS Lambda event definitions for cloudwatch_events.
 pub mod cloudwatch_events;
+/// AWS Lambda event definitions for cloudwatch_logs.
 pub mod cloudwatch_logs;
+/// AWS Lambda event definitions for code_commit.
 pub mod code_commit;
+/// AWS Lambda event definitions for codepipeline_job.
 pub mod codepipeline_job;
+/// AWS Lambda event definitions for cognito.
 pub mod cognito;
+/// AWS Lambda event definitions for config.
 pub mod config;
+/// AWS Lambda event definitions for connect.
 pub mod connect;
+/// AWS Lambda event definitions for firehose.
 pub mod firehose;
+/// AWS Lambda event definitions for iot_button.
 pub mod iot_button;
+/// AWS Lambda event definitions for kinesis.
 pub mod kinesis;
+/// AWS Lambda event definitions for lex.
 pub mod lex;
+/// AWS Lambda event definitions for s3.
 pub mod s3;
+/// AWS Lambda event definitions for ses.
 pub mod ses;
+/// AWS Lambda event definitions for sns.
 pub mod sns;
+/// AWS Lambda event definitions for sqs.
 pub mod sqs;

aws_lambda_events/src/lib.rs

@@ -14,6 +14,8 @@ extern crate serde_json;
 extern crate serde_json;
 
 mod custom_serde;
+/// Encodings used in AWS Lambda json event values.
 pub mod encodings;
+/// AWS Lambda event definitions.
 pub mod event;
 mod generated;

aws_lambda_events_codegen/src/main.rs

@@ -77,6 +77,10 @@ fn write_mod_index(
     if overwrite_warning(&mod_path, overwrite).is_none() {
         let mut mod_content: Vec<String> = Vec::new();
         for parsed in parsed_files {
+            mod_content.push(format!(
+                "/// AWS Lambda event definitions for {}.",
+                parsed.service_name
+            ));
             mod_content.push(format!(
                 "pub mod {};",
                 parsed