diff --git a/docs/CHANGES.md b/docs/CHANGES.md
index 14c7f60..e04419b 100644
--- a/docs/CHANGES.md
+++ b/docs/CHANGES.md
@@ -12,7 +12,7 @@ November 15th, 2015
 
 - implemented writing into ckan, see [supported operations table](README.md#supported-operations)
 - added CkanClient.builder() for setting connection parameters (proxy, timeout)
-- implemented DcatFactory for conversion to Dcat, see [supported operations table](README.md#dcat)
+- implemented DcatFactory for conversion to Dcat, see [ckan to dcat mappings](README.md#dcat)
 - split Ckan models into two (i.e. CkanDataset now extends CkanDatasetBase, and the Base is used when writing into Ckan)
 - now creating release zip with jar and dependencies
 - added many exceptions (all inherit from JackanException)
diff --git a/docs/README.md b/docs/README.md
index 507b99b..fade68d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -331,7 +331,7 @@ dataset metadata by navigating to /dataset/{id}.rdf or /dataset/{id}.n3.
 These were rendered using templates, and were outdated, incomplete and
 broken [1].
 ```
-Situation on ckan side is getting much better with the <a href="https://github.com/ckan/ckanext-dcat" target="_blank">new version of the plugin </a> in progress, but we cannot expect all CKAN instances around the world to adopt it now. So currently we provide a class to convert from CKAN objects to their DCAT equivalent called <a href="../src/main/java/eu.trentorise.opendata.jackan.dcat/DcatFactory"> DcatFactory</a>. It will convert a `CkanDataset` to a `DcatDataset` and a `CkanResource` to a `DcatDistribution` <a href="https://github.com/ckan/ckanext-dcat#rdf-dcat-to-ckan-dataset-mapping" target="_blank"> according to this mapping</a>.
+Situation on ckan side is getting much better with the <a href="https://github.com/ckan/ckanext-dcat" target="_blank">new version of the plugin </a> in progress, but we cannot expect all CKAN instances around the world to adopt it now. So currently we provide a class to convert from CKAN objects to their DCAT equivalent called <a href="../src/main/java/eu/trentorise/opendata/jackan/dcat/DcatFactory"> DcatFactory</a>. It will convert a `CkanDataset` to a `DcatDataset` and a `CkanResource` to a `DcatDistribution` <a href="https://github.com/ckan/ckanext-dcat#rdf-dcat-to-ckan-dataset-mapping" target="_blank"> according to this mapping</a>.
 
 Examples code:
 
@@ -359,9 +359,8 @@ Examples code:
                         Locale.ITALIAN); // default locale of metadata
 ```
 
-To extract more stuff during conversion, you can use <a href="../src/main/java/eu.trentorise.opendata.jackan.dcat/GreedyDcatFactory"> GreedyDcatFactory</a> or extend <a href="../src/main/java/eu.trentorise.opendata.jackan.dcat/DcatFactory"> DcatFactory</a> and override the extract* and/or postProcess* methods.
+To extract more stuff during conversion, you can use <a href="../src/main/java/eu/trentorise/opendata/jackan/dcat/GreedyDcatFactory"> GreedyDcatFactory</a> or extend <a href="../src/main/java/eu/trentorise/opendata/jackan/dcat/DcatFactory"> DcatFactory</a> and override the extract* and/or postProcess* methods.
 
-todo write about serializing Dcat to json?
 
 ### Logging