docs: Improved doc comments

Author: sirasistant

compiler/noirc_driver/src/contract.rs

@@ -35,6 +35,8 @@ pub struct CompiledContract {
     pub functions: Vec<ContractFunction>,
 
     /// All the events defined inside the contract scope.
+    /// An event is a struct value that can be emitted via oracles
+    /// by any contract function during execution.
     pub events: Vec<ContractEvent>,
 
     pub file_map: BTreeMap<FileId, DebugFile>,

compiler/noirc_frontend/src/hir/def_map/mod.rs

@@ -248,7 +248,7 @@ pub struct ContractFunctionMeta {
     pub is_entry_point: bool,
 }
 
-/// A 'contract' in Noir source code with the given name and functions.
+/// A 'contract' in Noir source code with a given name, functions and events.
 /// This is not an AST node, it is just a convenient form to return for CrateDefMap::get_all_contracts.
 pub struct Contract {
     /// To keep `name` semi-unique, it is prefixed with the names of parent modules via CrateDefMap::get_module_path