From cc75a92c7f2cb1035398c5b729dcd99b431d64ec Mon Sep 17 00:00:00 2001
From: Dimitry Ivanov <mail@dimitryivanov.ru>
Date: Wed, 30 Jan 2019 14:25:35 +0300
Subject: [PATCH] Theme legacy documentation warning about empty builder method
---
docs/docs/v2/getting-started.md | 2 +-
docs/docs/v2/image-loader.md | 2 +-
docs/docs/v2/theme.md | 15 ++++++++++++---
3 files changed, 14 insertions(+), 5 deletions(-)
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