diff --git a/README.md b/README.md
index dcfaf07..18d989e 100644
--- a/README.md
+++ b/README.md
@@ -6,25 +6,38 @@
[](https://github.com/PhasesResearchLab/dfttk/actions/workflows/test.yaml)
[](https://www.dfttk.org/en/main/?badge=main)
-## 📝 Overview
+## Overview
+Over the years, many tools have been developed to help set up and/or automate DFT calculations with VASP, as well as provide various post-processing features, such as [atomate2](https://github.com/materialsproject/atomate2), [quacc](https://github.com/Quantum-Accelerators/quacc), [AFLOW](https://www.aflowlib.org/), [AiiDA](https://www.aiida.net/), [pyiron](https://pyiron.org/), and [VASPKIT](https://vaspkit.com/). The **Density Functional Theory ToolKit (DFTTK)** is another addition to this space, with a philosophy of keeping the interface between the user and VASP as minimal as possible and making the automation and post-processing steps easy to see and understand.
-The **Density Functional Theory Toolkit (DFTTK)** is a Python package designed to automate VASP jobs and manage relevant results in MongoDB. VASP workflows leverage [Custodian](https://github.com/materialsproject/custodian), and data storage is handled via [PyMongo](https://github.com/mongodb/mongo-python-driver).
+DFTTK workflows use [Custodian](https://github.com/materialsproject/custodian) for job management. The usefulness of Custodian is that it allows many VASP jobs to be chained together and includes various self-correction strategies for handling VASP errors.
-## 🔧 What does DFTTK do?
+Current key features are listed below.
+
+## Key Features
### Enumeration of Configurations
-- Enumerates **unique collinear magnetic configurations** for a given structure.
+- Enumerates unique collinear magnetic configurations for a given structure.
### VASP Workflows
-- Performs **convergence tests** for:
+- Performs convergence tests for:
- Cutoff energy (`ENCUT`)
- k-points grid density (`kppa`)
-- Computes **free energy** using the **quasiharmonic approximation**.
-
-### MongoDB Storage
-- Stores and retrieves VASP **input data** and **post-processed results** in MongoDB.
-
-## ⚙️ Installation
+- Computes contributions to the Helmholtz energy, $F_k = E_k + F_{k,\text{vib}} + F_{k,\text{el}}$:
+ - $E_k$ — Energy–volume curves
+ - $F_{k,\text{vib}}$ — Phonons (post-processed with YPHON)
+ - $F_{k,\text{el}}$ — From the electronic DOS
+
+### Post-processing
+- $E_k$ — Fit energy–volume curves using an EOS
+- $F_{k,\text{vib}}$:
+ - Debye–Grüneisen model
+ - Phonons (via YPHON)
+- $F_{k,\text{el}}$ — From the electronic DOS
+
+### Configuration Class
+The Configuration class orchestrates VASP workflows to compute contributions to $F_k$, along with post-processing and storing results in MongoDB.
+
+## Installation
It is recommended first to set up a virtual environment using Conda:
conda create -n dfttk python=3.12
@@ -43,43 +56,28 @@ Or clone a specific branch:
cd dfttk
pip install -e .
-> 🛠️ **Note:** A PyPI release is currently under development.
+> **Note:** A PyPI release is currently under development.
+
+## Example Notebooks
+Click the badge below to open the project in GitHub Codespaces.
+Then, browse the `examples` folder to explore and run the example notebooks:
-## 📖 Documentation
+[](https://codespaces.new/PhasesResearchLab/dfttk?quickstart=1)
-For a comprehensive description of **DFTTK** and its capabilities, please refer to the [Official Documentation](https://vasp-job-automation.readthedocs.io/en/latest/index.html).
+| Notebooks | Description |
+|--------------|-------------|
+| DebyeGruneisen | Compute and plot vibrational contributions to the Helmholtz energy using the Debye–Grüneisen model for Al |
+| ThermalElectronic | Compute and plot thermal electronic contributions to the Helmholtz energy for Al using Fermi–Dirac statistics and the electronic DOS|
+| Configuration | Orchestrate VASP workflows to compute all contributions to $F_k$, with post-processing, plotting, and MongoDB storage for Al and Fe3Pt|
-> 🛠️ **Note:** The documentation is currently under construction. Some sections may be incomplete or subject to change.
+## Documentation
+For a comprehensive description of **DFTTK** and its capabilities, please refer to the [Official Documentation](https://www.dfttk.org/en/main/).
-## 📚 Citing DFTTK
+> **Note:** The documentation is currently under construction. Some sections may be incomplete or subject to change.
+## Citing DFTTK
If you use **DFTTK** in your work, please cite the following publication:
> **N. Hew et al.**,
> *Density Functional Theory ToolKit (DFTTK) to automate first-principles thermodynamics via the quasiharmonic approximation*, **Computational Materials Science**, Volume 258, 2025, 114072, ISSN 0927-0256.
> [https://doi.org/10.1016/j.commatsci.2025.114072](https://doi.org/10.1016/j.commatsci.2025.114072) ([View on ScienceDirect](https://www.sciencedirect.com/science/article/pii/S092702562500415X))
-
-## 🤝 Contributing
-
-We welcome bug reports, feature suggestions, and pull requests!
-
-### Getting Started
-1. Fork and clone the repo:
-
- git clone https://github.com//dfttk.git
-
-2. Create a new branch:
-
- git checkout -b my-feature
-
-3. Make changes, commit, push, and open a pull request to `main`.
-
-### 🐛 Reporting Issues
-Found a bug or have a suggestion?
-Please open an issue at [GitHub Issues](https://github.com/PhasesResearchLab/dfttk/issues) with:
-- A clear description
-- Steps to reproduce (if applicable)
-- Logs or screenshots
-
-> Thanks for helping improve **DFTTK**!
-