diff --git a/README.md b/README.md
index 89f056d..5b5615f 100644
--- a/README.md
+++ b/README.md
@@ -1,51 +1,10 @@
 # Yet Another Particle Transport IDE - converter
 
+## Developer documentation
+[Developer documentation](https://yaptide.github.io/for_developers/converter/)
+
+## About converter
 The Converter of the project file (JSON file generated by the frontend part) into a set of input files for particle transport simulators:
 
 - SHIELD-HIT12A (beam.dat, mat.dat, geo.dat and detect.dat).
 - Fluka
-
-## Installation
-
-Project make use of poetry for dependency management. If you do not have it installed, check official [poetry installation guide](https://python-poetry.org/docs/).
-Project is configured to create virtual environment for you, so you do not need to worry about it.
-Virtual environment is created in `.venv` folder in the root of the project.
-
-To install the project clone the repository and run the following command in the project directory:
-
-```shell
-poetry install --without=test
-```
-
-This will result in command `yaptide-converter` available inside the virtual environment.
-It can be accessed outside virtual environment by running `poetry run yaptide-converter`.
-Alternatively, you can run `poetry shell` to enter virtual environment or check more examples in [Poetry documentation section: Activating the virtual environment](https://python-poetry.org/docs/basic-usage#activating-the-virtual-environment).
-
-## Usage
-
-The converter comes with a command line application.
-It is capable of transforming the JSON project file (generated in the yaptide web interface) into a set of valid input files for SHIELD-HIT12A.
-
-To run the converter use the following command:
-
-```bash
-python converter/main.py tests/shieldhit/resources/project.json workspace
-```
-
-## Testing
-
-To run the unit tests, you need to install test dependencies with:
-
-```shell
-poetry install
-```
-
-Then you can run the tests with:
-
-```shell
-poetry run pytest
-```
-
-## Credits
-
-This work was partially funded by EuroHPC PL Project, Smart Growth Operational Programme 4.2
diff --git a/tests/README.md b/tests/README.md
deleted file mode 100644
index b8ba63c..0000000
--- a/tests/README.md
+++ /dev/null
@@ -1,16 +0,0 @@
-# Tests layout
-
-## General tests
-
-The general tests cover aspects of the converter common to all simulators.
-Currently only the Figures part of geometry is tested here.
-There is also `conftests.py` which contains fixture with location and content of a reference JSON project file.
-As for now this file is based on the SHIELD-HIT12A simualator, but could be used as well for Fluka and Topas tests.
-
-### Reference files
-
-The reference JSON file is located in `tests/shieldhit/resources/project.json` together with the expected output files.
-
-## Simulator specific tests
-
-The simulator specific tests cover aspects of the converter specific to a given simulator. They are located in the `shieldhit`, `fluka` and `topas` directories.