Update in respect to comments

design-documents/asynchronous-import/asycnhronous-import.md

@@ -31,13 +31,18 @@ Main idea of extension is to replace current Import module with new implementati
 - CSV reader;
 - Data Converting Rules;
 - Import Data Exchanging;
-- Import configuration;
+- Import Configuration;
 - Product import;
-- Stock status import;
+- Stock import;
 - Advanced pricing import;
 - Documentation;
 
+## UML
+
+![AsyncImportUML@2x](AsyncImportUML.png)
+
 ## TODO
-- Design of `Import configuration`;
-- Design of `Restart failed operations`;
-- Design of `Get Import status`;
+- Design of Import configuration;
+- Design of Get Import status;
+- Design of Import processing - Sync / Async
+- Design of Restart failed operations

design-documents/asynchronous-import/modularity/data-converting.md

@@ -79,6 +79,14 @@ interface ConvertingRuleInterface
 }
 ```
 
+Converting rules are transforming incoming data in a way, that Magento API can correctly understand them.
+
+#### Example: 
+Magento default  Advanced Pricing import *.csv file contains Magento Website assignment as a string value: "All Websites [ALL]".
+
+Magento API cannot recognise correct website base on this string representation, so this means we have to create converting rule that will define correct transformation from provided text to Magento Website ID.
+
+
 ### Extension points
 
 ```php

design-documents/asynchronous-import/modularity/import-csv.md

@@ -101,53 +101,6 @@ interface CsvFormatInterface extends ExtensibleDataInterface
 }
 ```
 
-```php
-/**
- * Describes how to parse data
- *
- * @api
- */
-interface CsvFormatInterface extends ExtensibleDataInterface
-{
-    /**
-     * Get CSV Escape
-     *
-     * @return string|null
-     */
-    public function getEscape(): ?string;
-
-    /**
-     * Get CSV Enclosure
-     *
-     * @return string|null
-     */
-    public function getEnclosure(): ?string;
-
-    /**
-     * Get CSV Delimiter
-     *
-     * @return string|null
-     */
-    public function getDelimiter(): ?string;
-
-    /**
-     * Get Multiple Value Separator
-     *
-     * @return string|null
-     */
-    public function getMultipleValueSeparator(): ?string;
-
-    /**
-     * Get existing extension attributes object
-     *
-     * Used fully qualified namespaces in annotations for proper work of extension interface/class code generation
-     *
-     * @return \Magento\AsynchronousImportCsvApi\Api\Data\CsvFormatExtensionInterface|null
-     */
-    public function getExtensionAttributes(): ?CsvFormatExtensionInterface;
-}
-```
-
 ### Extension points
 
 ```php

design-documents/asynchronous-import/rest-api.md.md

@@ -42,9 +42,9 @@ Single entry point for **partial** reading and import of data.
   }
   "format': {
     "escape": "|"
-    "enclosure" : "|"
-    "delimiter" => "|"
-    "multipleValueSeparator" : "|"
+    "enclosure": "|"
+    "delimiter": "|"
+    "multipleValueSeparator": "|"
     "extensionAttributes": []
   }
   "convertingRules": [
@@ -80,6 +80,6 @@ Where is:
 
 ```
 {
-  "UUID": "uuid_string"
+  "uuid": "uuid_string"
 }
 ```