diff --git a/drivers/FlashIAP.h b/drivers/FlashIAP.h
index dd7b167..a6acc1b 100644
--- a/drivers/FlashIAP.h
+++ b/drivers/FlashIAP.h
@@ -112,6 +112,7 @@
 
     /** Get the program page size
      *
+     *  The page size defines the writable page size
      *  @return Size of a program page in bytes
      */
     uint32_t get_page_size() const;
diff --git a/hal/flash_api.h b/hal/flash_api.h
index 1804250..4231c08 100644
--- a/hal/flash_api.h
+++ b/hal/flash_api.h
@@ -75,9 +75,9 @@
  */
 int32_t flash_read(flash_t *obj, uint32_t address, uint8_t *data, uint32_t size);
 
-/** Program one page starting at defined address
+/** Program pages starting at defined address
  *
- * The page should be at page boundary, should not cross multiple sectors.
+ * The pages should not cross multiple sectors.
  * This function does not do any check for address alignments or if size is aligned to a page size.
  * @param obj The flash object
  * @param address The sector starting address
@@ -97,6 +97,7 @@
 
 /** Get page size
  *
+ * The page size defines the writable page size
  * @param obj The flash object
  * @return The size of a page
  */