diff --git a/docs/compatibility.md b/docs/compatibility.md
index bda15a73c..4066f2357 100644
--- a/docs/compatibility.md
+++ b/docs/compatibility.md
@@ -34,7 +34,7 @@ branch, unless the older version has bugs that lead to data corruption.
 
 To support this,
  - Serialization forms of any classes should be changed. When e. g. a marshaller class (say,
- `StringBytesReader`) of object of some type is changed, and it's serialization form should be
+ `StringBytesReader`) of objects of some type is changed, and it's serialization form should be
  changed, a new class called `StringBytesReader_3_5` (5 is the "minor" number of the version of the
  library, in which this change is made) should be created and put along with older class.
  - When the specification revision is updated (hence binary form could be completely changed), a
@@ -59,4 +59,5 @@ If more substantial changes to the specification are required, the revision numb
 updated.
 
 The binary form of Chronicle Map and algorithms could change between revisions to any degree, but
-[guarantees](../spec/1-design-goals.md) provided by the specification shouldn't be weaken.
\ No newline at end of file
+[guarantees](../spec/1-design-goals.md#guarantees) provided by the specification shouldn't be
+weaken.
diff --git a/src/main/java/net/openhft/chronicle/map/MapContext.java b/src/main/java/net/openhft/chronicle/map/MapContext.java
index 3bc67169f..009edac5e 100644
--- a/src/main/java/net/openhft/chronicle/map/MapContext.java
+++ b/src/main/java/net/openhft/chronicle/map/MapContext.java
@@ -24,7 +24,11 @@ import net.openhft.chronicle.hash.Data;
  * Context, in which {@link MapEntry MapEntries} are accessed. {@code MapContext} allows to access
  * {@link MapEntryOperations}, configured for the accessed {@link ChronicleMap} via {@link
  * ChronicleMapBuilder#entryOperations(MapEntryOperations)}. {@code MapContext} implements {@code
- * MapEntryOperations} by delegation to the configured {@code entryOperations}.
+ * MapEntryOperations} by delegation to the configured {@code entryOperations}. The same for
+ * {@link DefaultValueProvider}: {@code MapContext} delegates to the {@code DefaultValueProvider}
+ * configured for the accessed {@code ChronicleMap} via {@link
+ * ChronicleMapBuilder#defaultValueProvider(DefaultValueProvider)}, or the default {@code
+ * DefaultValueProvider} implementation.
  * 
  * @param <K> the map key type
  * @param <V> the map value type