diff --git a/docs/docs/v2/getting-started.md b/docs/docs/v2/getting-started.md
index 356fd856..cb622232 100644
--- a/docs/docs/v2/getting-started.md
+++ b/docs/docs/v2/getting-started.md
@@ -22,7 +22,7 @@ Toast.makeText(context, markdown, Toast.LENGTH_LONG).show();
 
 ## Longer one
 
-When you need to customize markdown parsing/rendering you can use [SpannableConfiguration](/docs/configure.md):
+When you need to customize markdown parsing/rendering you can use [SpannableConfiguration](/docs/v2/configure.md):
 
 ```java
 final SpannableConfiguration configuration = SpannableConfiguration.builder(context)
diff --git a/docs/docs/v2/image-loader.md b/docs/docs/v2/image-loader.md
index 75275961..c64bbe36 100644
--- a/docs/docs/v2/image-loader.md
+++ b/docs/docs/v2/image-loader.md
@@ -23,7 +23,7 @@ public interface Loader {
 `AsyncDrawableLoader` from `markwon-image-loader` artifact can be used.
 
 :::tip Install
-[Learn how to add](/docs/v2/install.md#image-loader) `markwon-image-loader` to your project
+[Learn how to add](/docs/v2/README.md#image-loader) `markwon-image-loader` to your project
 :::
 
 Default instance of `AsyncDrawableLoader` can be obtain like this:
diff --git a/docs/docs/v2/theme.md b/docs/docs/v2/theme.md
index 617b7e47..b0cdbe8a 100644
--- a/docs/docs/v2/theme.md
+++ b/docs/docs/v2/theme.md
@@ -2,11 +2,20 @@
 
 # Theme
 
-Here is the list of properties that can be configured via `SpannableTheme#builder` factory
-method. If you wish to control what is out of this list, you can use [SpannableFactory](/docs/v2/factory.md)
+Here is the list of properties that can be configured via `SpannableTheme`. If you wish to control what 
+is out of this list, you can use [SpannableFactory](/docs/v2/factory.md)
 abstraction which lets you to gather full control of Spans that are used to display markdown.
 
-* factory methods
+* `SpannableTheme#create(Context)` - creates a **default** instance of `SpannableBuilder (with _defaults_ registered)
+* `SpannableTheme#builder` - creates **empty** builder with **no defaults registered**
+* `SpannableTheme#builderWithDefaults(Context)` - create a **default** instance of builder (with default values registered)
+
+:::warning
+`SpannbleTheme#builder` method has an unfortunate naming. It should've been `emptyBuilder`
+or `builderNoDefaults` because `#builder` method returns a builder with <strong>no default
+theme values registered</strong>. To create a builder **with** default values registered
+use `SpannableBuilder#builderWithDefaults(Context)`
+:::
 
 ## Link color