diff --git a/examples/crust.rs b/examples/crust.rs
index 7a408daf211785079f71513db881e43c7a098811..408d0c1f3ae1905607221c232b67661968df8ba4 100644
--- a/examples/crust.rs
+++ b/examples/crust.rs
@@ -69,6 +69,7 @@ fn main() -> Result<(), Box<dyn Error>> {
     Ok(())
 }
 
+/// Compiler holds the LLVM state for the compilation
 pub struct Compiler<'a> {
     pub context: &'a Context,
     pub builder: &'a Builder,
@@ -79,6 +80,7 @@ pub struct Compiler<'a> {
     fn_value_opt: Option<FunctionValue>,
 }
 
+/// Compilation assumes the program to be semantically correct (well formed)
 impl<'a> Compiler<'a> {
     /// Gets a defined function given its name.
     #[inline]