diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 0b6b0f08cfcda23477f2ceb75f0dd8a49ea80c4a..592bebfdfce7c058a6cdd392b228d4d02e9d43e6 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -12,3 +12,12 @@ unit_tests:
   stage: test
   script:
     - true
+# vagrant_backed_tests
+#   stage: test
+#   script:
+#     - vagrant ssh -c 'sudo shutdown -P +10'
+#     - vagrant ssh -c 'cd /vagrant; nosetests --with-coverage'
+#    before_script:
+#      - vagrant up
+#    after_script:
+#      - vagrant destroy -f
\ No newline at end of file
diff --git a/README.md b/README.md
index d567c3d733179a30c57697c353e562c63a2c2314..1e16c886af9fce080ebada67c0a1c7f597201f66 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,36 @@
-# your_project
+your_project
+============
+[![build status](http://git.dms-serwis.com.pl/smok4/svcr/badges/master/build.svg)](http://git.dms-serwis.com.pl/henrietta/py-scaffold/commits/master)
+[![coverage report](http://git.dms-serwis.com.pl/smok4/svcr/badges/master/coverage.svg)](http://git.dms-serwis.com.pl/henrietta/py-scaffold/commits/master)
 
-This is a scaffold of your project.
+This is a generic scaffold for Python projects that use:
+* this GitLab CI for builds/tests/deploys
+* _coverage.py_ for test coverage
+* _nose_ for unit tests
+* _Vagrant_ for environment
+* _setuptools_ for packaging
+* 
 
-Todo:
-* rename [your_project_source](your_project_source)
-    * adjust [setup.py](setup.py)
-    * adjust [.coveragerc](.coveragerc)
-* adjust [license](LICENSE)
-* adjust [Vagrantfile](Vagrantfile), or remove it
-* adjust [MANIFEST.in](MANIFEST.in) if you have data files
+# How to use
 
-[![build status](http://git.dms-serwis.com.pl/smok4/svcr/badges/master/build.svg)](http://git.dms-serwis.com.pl/smok4/svcr/commits/master)
-[![coverage report](http://git.dms-serwis.com.pl/smok4/svcr/badges/master/coverage.svg)](http://git.dms-serwis.com.pl/smok4/svcr/commits/master)
+1. `git clone http://git.dms-serwis.com.pl/henrietta/py-scaffold.git`
+2. Delete `.git` directory
+3. Adjust this code to your project
+  3.1. Rename [your_project_source](your_project_source) to match your project
+  3.2. adjust [setup.py](setup.py)
+  3.3. adjust [.coveragerc](.coveragerc)
+  3.4. adjust [license](LICENSE)
+  3.5. adjust [Vagrantfile](Vagrantfile), or remove it
+  3.6. adjust [MANIFEST.in](MANIFEST.in) if you have data files
+  3.7. adjust [docs](docs/)
+  3.8. adjust [gitlab-ci.yml](.gitlab-ci.yml), especially if your tests require a 
+       Vagrant environment
+4. Set up a repository on GitLab
+5. Ensure you have _master_ permission on this repository
+6. Set `^TOTAL\s+\d+\s+\d+\s+\d+\s+\d+\s+(\d+)%$` in 
+  _Settings>CI/CD Pipelines>Test coverage parsing_ for GitLab to display
+  test coverage data
+7. `git init`
+8. Add suitable remotes, commit the data, push to repo
+9. Done!
+  
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..5468404be58dfe3a90f2e6510eac2522abb90f9c
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,5 @@
+# your-project docs
+
+This is index file for documentation, if any is needed,
+or any should remain here and not somewhere else (eg.
+Confluence).