diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..8aa6c33
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,11 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+### Added
+- Achieved Feature parity with parser implementation in [dalance/svlint](https://github.com/dalance/svlint/)
+- Parse files, include directories and defines
+- Support environment variables
\ No newline at end of file
diff --git a/README.md b/README.md
index 0981504..a66e382 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,11 @@
 # Verilog Filelist Parser
 
 A library in Rust to parse a Verilog Filelist and return
-a list of files, include directories and defines
+a list of files, include directories and defines.
+
+Environment variables represented with paranthesis or 
+curly braces (i.e. $() or ${}) will be automatically
+substituted.
 
 # Example
 ```rust
diff --git a/src/file_parser.rs b/src/file_parser.rs
index 0b65cb6..dd38f1b 100644
--- a/src/file_parser.rs
+++ b/src/file_parser.rs
@@ -44,11 +44,14 @@ impl Filelist {
     }
 }
 
-/// Parses a filelist file
-///
+/// Parses a filelist file.
+/// 
+/// Environment variables represented with paranthesis or 
+/// curly braces (i.e. `$()` or `${}`) will be automatically
+/// substituted.
 /// # Arguments
 ///
-/// * `path` - A string slice that is the path to the filelist file
+/// * `path` - A string slice that is the path to the filelist
 ///
 /// # Errors
 ///
diff --git a/src/lib.rs b/src/lib.rs
index a9b5877..052041f 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,7 +1,11 @@
 //! # Verilog Filelist Parser
 //! 
 //! A library to parse a Verilog Filelist and return
-//! a list of files, include directories and defines
+//! a list of files, include directories and defines.
+//! 
+//! Environment variables represented with paranthesis or 
+//! curly braces (i.e. `$()` or `${}`) will be automatically
+//! substituted.
 //! 
 //! # Example
 //! ```