diff --git a/features/filesystem/bd/BlockDevice.h b/features/filesystem/bd/BlockDevice.h
index b6e195cb70..de86051ff9 100644
--- a/features/filesystem/bd/BlockDevice.h
+++ b/features/filesystem/bd/BlockDevice.h
@@ -139,11 +139,11 @@ public:
     /** Get the value of storage when erased
      *
      *  If get_erase_value returns a non-negative byte value, the underlying
-     *  storage will be set to that value when erased, and storage containing
+     *  storage is set to that value when erased, and storage containing
      *  that value can be programmed without another erase.
      *
-     *  @return         The value of storage when erased, or -1 if the value of
-     *                  erased storage can't be relied on
+     *  @return         The value of storage when erased, or -1 if you can't
+     *                  rely on the value of erased storage
      */
     virtual int get_erase_value() const
     {
diff --git a/features/filesystem/bd/ChainingBlockDevice.h b/features/filesystem/bd/ChainingBlockDevice.h
index db4594536f..9b1cbb944e 100644
--- a/features/filesystem/bd/ChainingBlockDevice.h
+++ b/features/filesystem/bd/ChainingBlockDevice.h
@@ -139,11 +139,11 @@ public:
     /** Get the value of storage when erased
      *
      *  If get_erase_value returns a non-negative byte value, the underlying
-     *  storage will be set to that value when erased, and storage containing
+     *  storage is set to that value when erased, and storage containing
      *  that value can be programmed without another erase.
      *
-     *  @return         The value of storage when erased, or -1 if the value of
-     *                  erased storage can't be relied on
+     *  @return         The value of storage when erased, or -1 if you can't
+     *                  rely on the value of erased storage
      */
     virtual int get_erase_value() const;
 
diff --git a/features/filesystem/bd/ExhaustibleBlockDevice.h b/features/filesystem/bd/ExhaustibleBlockDevice.h
index 7fedc22a61..5e5b47574e 100644
--- a/features/filesystem/bd/ExhaustibleBlockDevice.h
+++ b/features/filesystem/bd/ExhaustibleBlockDevice.h
@@ -122,11 +122,11 @@ public:
     /** Get the value of storage when erased
      *
      *  If get_erase_value returns a non-negative byte value, the underlying
-     *  storage will be set to that value when erased, and storage containing
+     *  storage is set to that value when erased, and storage containing
      *  that value can be programmed without another erase.
      *
-     *  @return         The value of storage when erased, or -1 if the value of
-     *                  erased storage can't be relied on
+     *  @return         The value of storage when erased, or -1 if you can't
+     *                  rely on the value of erased storage
      */
     virtual int get_erase_value() const;
 
diff --git a/features/filesystem/bd/MBRBlockDevice.h b/features/filesystem/bd/MBRBlockDevice.h
index 322a32a15a..d214c0a2b5 100644
--- a/features/filesystem/bd/MBRBlockDevice.h
+++ b/features/filesystem/bd/MBRBlockDevice.h
@@ -193,11 +193,11 @@ public:
     /** Get the value of storage when erased
      *
      *  If get_erase_value returns a non-negative byte value, the underlying
-     *  storage will be set to that value when erased, and storage containing
+     *  storage is set to that value when erased, and storage containing
      *  that value can be programmed without another erase.
      *
-     *  @return         The value of storage when erased, or -1 if the value of
-     *                  erased storage can't be relied on
+     *  @return         The value of storage when erased, or -1 if you can't
+     *                  rely on the value of erased storage
      */
     virtual int get_erase_value() const;
 
diff --git a/features/filesystem/bd/ObservingBlockDevice.h b/features/filesystem/bd/ObservingBlockDevice.h
index 7e5a21dd92..0a265dc1b6 100644
--- a/features/filesystem/bd/ObservingBlockDevice.h
+++ b/features/filesystem/bd/ObservingBlockDevice.h
@@ -108,11 +108,11 @@ public:
     /** Get the value of storage when erased
      *
      *  If get_erase_value returns a non-negative byte value, the underlying
-     *  storage will be set to that value when erased, and storage containing
+     *  storage is set to that value when erased, and storage containing
      *  that value can be programmed without another erase.
      *
-     *  @return         The value of storage when erased, or -1 if the value of
-     *                  erased storage can't be relied on
+     *  @return         The value of storage when erased, or -1 if you can't
+     *                  rely on the value of erased storage
      */
     virtual int get_erase_value() const;
 
diff --git a/features/filesystem/bd/ProfilingBlockDevice.h b/features/filesystem/bd/ProfilingBlockDevice.h
index b8c3295c51..ff0782b90e 100644
--- a/features/filesystem/bd/ProfilingBlockDevice.h
+++ b/features/filesystem/bd/ProfilingBlockDevice.h
@@ -125,11 +125,11 @@ public:
     /** Get the value of storage when erased
      *
      *  If get_erase_value returns a non-negative byte value, the underlying
-     *  storage will be set to that value when erased, and storage containing
-     *  that value can be programmed without another erase.
+     *  storage is set to that value when erased, and you can program storage
+     *  containing that value without another erase.
      *
-     *  @return         The value of storage when erased, or -1 if the value of
-     *                  erased storage can't be relied on
+     *  @return         The value of storage when erased, or -1 if you can't
+     *                  rely on the value of erased storage
      */
     virtual int get_erase_value() const;
 
diff --git a/features/filesystem/bd/ReadOnlyBlockDevice.h b/features/filesystem/bd/ReadOnlyBlockDevice.h
index 31462fad91..a99f05ecfe 100644
--- a/features/filesystem/bd/ReadOnlyBlockDevice.h
+++ b/features/filesystem/bd/ReadOnlyBlockDevice.h
@@ -101,11 +101,11 @@ public:
     /** Get the value of storage when erased
      *
      *  If get_erase_value returns a non-negative byte value, the underlying
-     *  storage will be set to that value when erased, and storage containing
+     *  storage is set to that value when erased, and storage containing
      *  that value can be programmed without another erase.
      *
-     *  @return         The value of storage when erased, or -1 if the value of
-     *                  erased storage can't be relied on
+     *  @return         The value of storage when erased, or -1 if you can't
+     *                  rely on the value of erased storage
      */
     virtual int get_erase_value() const;
 
diff --git a/features/filesystem/bd/SlicingBlockDevice.h b/features/filesystem/bd/SlicingBlockDevice.h
index 635eab81e9..9fadf05b81 100644
--- a/features/filesystem/bd/SlicingBlockDevice.h
+++ b/features/filesystem/bd/SlicingBlockDevice.h
@@ -131,11 +131,11 @@ public:
     /** Get the value of storage when erased
      *
      *  If get_erase_value returns a non-negative byte value, the underlying
-     *  storage will be set to that value when erased, and storage containing
+     *  storage is set to that value when erased, and storage containing
      *  that value can be programmed without another erase.
      *
-     *  @return         The value of storage when erased, or -1 if the value of
-     *                  erased storage can't be relied on
+     *  @return         The value of storage when erased, or -1 if you can't
+     *                  rely on the value of erased storage
      */
     virtual int get_erase_value() const;