diff --git a/README.md b/README.md
index 06b87b7f63402b578bdebd8eb051343da04d80d0..4ac45c8c94da2dce9ca3e78f166cad866fd37284 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,82 @@
-# parcel-project-template
\ No newline at end of file
+# parcel-project-template
+
+## Developing
+
+### Prerequisites
+
+Для корректной работы SASS-компилятора и других инструментов, необходимо один
+раз глобально поставить дополнительные пакеты, выполнив в терминале следующие
+команды. Пользователям MacOS ничего делать не нужно.
+
+Пользователям **Windows**, в режиме администратора.
+
+```shell
+npm install --global windows-build-tools
+```
+
+Пользователям **Linux**.
+
+```shell
+sudo apt-get install gcc g++ make
+```
+
+### Setting up Dev
+
+Один раз на проект установить все зависимости.
+
+```shell
+npm install
+```
+
+И запустить режим разработки.
+
+```shell
+npm start
+```
+
+Во вкладке браузера перейти по адресу
+[http://localhost:1234](http://localhost:1234).
+
+### Building
+
+Для того чтобы создать оптимизированные файлы для хостинга, необходимо выполнить
+следующую команду. В корне проекта появится папка `build` со всеми
+оптимизированными ресурсами.
+
+```shell
+npm run build
+```
+
+### Deploying / Publishing
+
+Сборка может автоматически деплоить билд на GitHub Pages удаленного (remote)
+репозитория. Для этого необходимо в файле `package.json` отредактировать поле
+`homepage`, заменив имя пользователя и репозитория на свои.
+
+```json
+"homepage": "https://имя_пользователя.github.io/имя_репозитория"
+```
+
+Также необходимо отредактировать скрипт "predeploy".
+
+```json
+"predeploy": "npm run build -- --public-url='/имя_репозитория/'"
+```
+
+После чего в терминале выполнить следующую команду.
+
+```shell
+npm run deploy
+```
+
+Если нет ошибок в коде и свойство `homepage` указано верно, запустится сборка
+проекта в продакшен, после чего содержимое папки `build` будет помещено в ветку
+`gh-pages` на удаленном (remote) репозитории. Через какое-то время живую
+страницу можно будет посмотреть по адресу указанному в отредактированном
+свойстве `homepage`.
+
+## Configuration
+
+- Все паршалы файлов стилей должны лежать в папке `src/sass` и импортироваться в
+  `src/sass/main.scss`
+- Изображения добавляйте в папку `src/images`
diff --git a/src/images/demo.jpg b/src/images/demo.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..3d26b41648f0609274bc12fa0a349600ec502d80
Binary files /dev/null and b/src/images/demo.jpg differ
diff --git a/src/sass/main.scss b/src/sass/main.scss
index c0919efe8d86760603cc30456a5c64f2aae272b9..269c79c220a767121139a76b961826ddf0aba61e 100644
--- a/src/sass/main.scss
+++ b/src/sass/main.scss
@@ -4,4 +4,4 @@
  */
 
 // Стили для файла с примером HTML-фрагмента
-@import "./example";
+@import './example';