diff --git a/include/vkcv/Context.hpp b/include/vkcv/Context.hpp
index b756373dde0863795ee6aeaf5faefbcbdc02e159..d91855a54c83f17b8251aad7c6fe2cb2591f9add 100644
--- a/include/vkcv/Context.hpp
+++ b/include/vkcv/Context.hpp
@@ -16,7 +16,9 @@ namespace vkcv
 {
 	
 	/**
-	 * @brief Class to manage the vulkan resources as an instance,
+	 * @brief Class to manage core resources for vulkan callbacks.
+	 *
+	 * The class to manage the vulkan resources as an instance,
 	 * a device, a physical device and a memory allocator. Additionally
 	 * instances of this class will hold the feature manager and the
 	 * queue manager.
diff --git a/include/vkcv/Core.hpp b/include/vkcv/Core.hpp
index 86c1586da0b938646df45a7e7702b83a56aca7cc..29fe152f6d14fdcea06a3c35124b0367c6c12dc1 100644
--- a/include/vkcv/Core.hpp
+++ b/include/vkcv/Core.hpp
@@ -53,8 +53,10 @@ namespace vkcv
 	};
 
 	/**
-	 * @brief The class handles the core functionality of the framework with
-	 * most calls addressing resource management via more simplified abstraction.
+	 * @brief Class to handle the core functionality of the framework.
+	 *
+	 * The class handles the core functionality of the framework with most
+	 * calls addressing resource management via more simplified abstraction.
 	 */
     class Core final
     {