Documentation added

README.md

@@ -15,25 +15,65 @@ By default, the package transliterates in accordance with the Łacinka rules.
 ```javascript
 import belLat from '@skip405/bel-lat';
 
-belLat('Лацінка') // Łacinka
+belLat('Лацінка'); // Łacinka
 ```
 
 which is equivalent to:
 
 ```javascript
 import belLat from '@skip405/bel-lat';
 
-belLat('Лацінка', { style: 'lacinka' }) // Łacinka
+belLat('Лацінка', { style: 'lacinka' }); // Łacinka
 ```
 
+## Instruction for geographical names
+
 You can specify conversion in accordance with the instruction for geographical names, e.g.
 
 ```javascript
 import belLat from '@skip405/bel-lat';
 
-belLat('Лацінка', { style: 'geographical' }) // Lacinka
+belLat('Лацінка', { style: 'geographical' }); // Lacinka
+```
+
+## Creating slugs
+
+The package uses the wonderful [@sindresorhus/slugify](https://github.com/sindresorhus/slugify) package to create slugified strings after conversion.
+
+```javascript
+import belLat from '@skip405/bel-lat';
+
+belLat("прывітанне, сусвет", { style: 'slugify' }); // pryvitannie-susviet
+```
+
+## Basic replacements
+
+The package allows to specify own replacement symbols.
+
+```javascript
+import belLat from '@skip405/bel-lat';
+
+belLat("№", {
+  customReplacements: [ ['№', { regular: '#' }] ]
+}); // #
+```
+
+**N.B.** if you need more complex conversions please prepare the string beforehand using other means.
+
+## Basic omissions
+
+If you'd like to omit any characters from conversion you can specify `_omitted` as a value for a custom replacement.
+
+```javascript
+import belLat from '@skip405/bel-lat';
+
+belLat("абв", {
+  customReplacements: [ ['б', '_omitted'] ]
+}); // av
 ```
 
+**N.B.** conversion is done on a per-character basis, it is not possible to omit multiple characters in a single call.
+
 ## Testing
 
 ```