diff --git a/src/site/apt/examples/inplace2ascii.apt b/src/site/apt/examples/inplace2ascii.apt
new file mode 100644
index 0000000..928c316
--- /dev/null
+++ b/src/site/apt/examples/inplace2ascii.apt
@@ -0,0 +1,41 @@
+ ------
+ Converting Resources Inplace
+ ------
+ David Matejcek
+ ------
+ 2017-12-23
+ ------
+
+Converting UTF-8 properties to standard inplace
+
+ This goal targets the scenario known from 1-beta version - conversion of
+ UTF-8 file content to Unicode-escaped content on the same file.
+
+ Note that this target is not covered by eclipse lifecycle.
+
+---
+
+ org.codehaus.mojo
+ native2ascii-maven-plugin
+ ____
+
+
+ utf8-to-latin1
+
+ inplace
+
+ process-resources
+
+ ${project.build.testOutputDirectory}/localized
+ ${project.build.sourceEncoding}
+
+ **/*.properties
+
+
+
+
+
+
+
+
+---
diff --git a/src/site/apt/examples/resources2ascii.apt b/src/site/apt/examples/resources2ascii.apt
new file mode 100644
index 0000000..678c23d
--- /dev/null
+++ b/src/site/apt/examples/resources2ascii.apt
@@ -0,0 +1,40 @@
+ ------
+ Converting Resources
+ ------
+ David Matejcek
+ ------
+ 2017-12-23
+ ------
+
+Converting UTF-8 properties to standard
+
+ This goal targets the basic scenario - conversion of UTF-8 files to Unicode-escaped files
+ without any change of the originals.
+
+---
+
+ org.codehaus.mojo
+ native2ascii-maven-plugin
+ ____
+
+
+ utf8-to-latin1
+
+ resources
+
+ process-resources
+
+ src/main/native2ascii
+ ${project.build.outputDirectory}
+ ${project.build.sourceEncoding}
+
+ **/*.properties
+
+
+
+
+
+
+
+
+---
diff --git a/src/site/apt/examples/test-resources2ascii.apt b/src/site/apt/examples/test-resources2ascii.apt
new file mode 100644
index 0000000..e1ea64d
--- /dev/null
+++ b/src/site/apt/examples/test-resources2ascii.apt
@@ -0,0 +1,40 @@
+ ------
+ Converting Test Resources
+ ------
+ David Matejcek
+ ------
+ 2017-12-23
+ ------
+
+Converting UTF-8 properties to standard
+
+ This goal targets the basic testing scenario - conversion of UTF-8 files to Unicode-escaped files
+ without any change of the originals or the target artifact.
+
+---
+
+ org.codehaus.mojo
+ native2ascii-maven-plugin
+ ____
+
+
+ utf8-to-latin1
+
+ testResources
+
+ process-test-resources
+
+ src/test/native2ascii
+ ${project.build.testOutputDirectory}
+ ${project.build.sourceEncoding}
+
+ **/*.properties
+
+
+
+
+
+
+
+
+---
diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt
index e04fedd..c841c33 100644
--- a/src/site/apt/index.apt
+++ b/src/site/apt/index.apt
@@ -1,26 +1,19 @@
------
Introduction
------
- Evgeny Mandrikov
-
+ David Matejcek
+
------
- 2011-11-04
+ 2017-12-23
------
Native2Ascii Maven Plugin
- This plugin converts files with characters in any supported character encoding to one with ASCII and/or Unicode escapes.
-
-
-* Goals Overview
-
- * {{{./native2ascii-mojo.html}native2ascii:native2ascii}}: Run the conversion.
-
- []
-
-
-* Usage
-
- Instructions on how to use the Native2Ascii Maven Plugin can be found on the {{{./usage.html}usage page}}.
+ This plugin provides solution for developers who maintain property files in UTF-8 encoding
+ but runtime needs ASCII and supports Unicode-escaped characters just like Java's
+ java.util.Properties class.
+ This plugin converts files in any supported character encoding to one with ASCII
+ and/or Unicode escapes.
+ See {{{./plugin-info.html}Goals}} and Examples to see more.
diff --git a/src/site/apt/usage.apt b/src/site/apt/usage.apt
deleted file mode 100644
index 9f89dff..0000000
--- a/src/site/apt/usage.apt
+++ /dev/null
@@ -1,45 +0,0 @@
- ------
- Usage
- ------
- Evgeny Mandrikov
-
- ------
- 2011-11-04
- ------
-
-Usage
-
- The plugin is bound to the <<>> phase of the build lifecycle.
- The plugin should be declared at the <<<\>>> section of the POM to trigger
- the execution.
-
----------------------------
-
- [...]
-
- [...]
-
- [...]
-
- org.codehaus.mojo
- native2ascii-maven-plugin
-
-
-
- native2ascii
-
-
- [...]
-
-
- [...]
-
- [...]
-
- [...]
-
- [...]
-
- [...]
-
----------------------------
diff --git a/src/site/site.xml b/src/site/site.xml
index 4abe435..1b91a5e 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -4,15 +4,15 @@
-