Add support for docs to create_enum (#1851)

* Add support for docs to create_enum

Enables specifying docs for each enum value.

* cargo fmt

Author: jhendrixMSFT

sdk/typespec/typespec_client_core/src/macros.rs

@@ -9,11 +9,12 @@
 /// Turns into a struct where each variant can be turned into and construct from the corresponding string.
 #[macro_export]
 macro_rules! create_enum {
-    ($(#[$meta:meta])* $name:ident, $(($variant:ident, $value:expr)), *) => (
-        $(#[$meta])*
+    ($(#[$type_doc:meta])* $name:ident, $($(#[$val_doc:meta])* ($variant:ident, $value:expr)), *) => (
+        $(#[$type_doc])*
         #[derive(Debug, PartialEq, Eq, PartialOrd, Clone, Copy)]
         pub enum $name {
             $(
+                $(#[$val_doc])*
                 $variant,
             )*
         }
@@ -157,6 +158,17 @@ mod test {
     create_enum!(Colors, (Black, "Black"), (White, "White"), (Red, "Red"));
     create_enum!(ColorsMonochrome, (Black, "Black"), (White, "White"));
 
+    create_enum!(
+        #[doc = "Defines operation states"]
+        OperationState,
+        #[doc = "The operation hasn't started"]
+        (NotStarted, "notStarted"),
+        #[doc = "The operation is in progress"]
+        (InProgress, "inProgress"),
+        #[doc = "The operation has completed"]
+        (Completed, "completed")
+    );
+
     struct Options {
         a: Option<String>,
         b: u32,