diff --git a/README.en.md b/README.en.md
new file mode 100644
index 0000000..75c6442
--- /dev/null
+++ b/README.en.md
@@ -0,0 +1,45 @@
+# WorldLang
+
+[Русский](README.md) · **English**
+
+[](https://github.com/EDeev/webdev-exam-2025-1-devik/actions/workflows/ci.yml)
+
+Exam project for the "Web Technologies Basics" course: an online language school site with a course and
+tutor catalog, applications, a personal account and a map of learning places, built on the course API.
+
+**Status:** coursework (Moscow Polytech, group 241-327, exam, January 2026), completed, archived ·
+site at [lang.deev.su](https://lang.deev.su) (the course API is not always available)
+
+
+
+**Stack:** HTML5 · CSS3 · JavaScript (ES6+, fetch) · Bootstrap 5 · Yandex Maps API
+
+- Course and tutor catalog with search, filters and pagination
+- Application form with price calculation, date and time selection
+- Personal account: view, edit and delete applications
+- Map of learning places (Yandex Maps) with a list
+- API data is escaped before insertion into the page (`esc()` in `js/utils.js`)
+
+## Running
+
+The site is static. On [lang.deev.su](https://lang.deev.su) nginx serves the files and proxies the course
+API at `/api`. To run from disk, put the full API URL (given in a comment) into `js/api.js` and open
+`index.html`.
+
+Checks: `node --check js/*.js` and `npx htmlhint *.html` (rules in `.htmlhintrc`, also run by CI).
+
+## License
+
+Coursework (Web Technologies Basics, Moscow Polytechnic University, 2025/26). The code is open for study;
+there is no separate license.
+
+## Author
+
+**Egor Deev** — [GitHub](https://github.com/EDeev) · [Telegram](https://t.me/DeevEgor) · [egor@deev.space](mailto:egor@deev.space)
+
+---
+
+
+
⭐ If you find this project useful, give it a star on GitHub!
+
Made with ❤️ — deev.space
+
diff --git a/README.md b/README.md
index afa0922..9163ea0 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,45 @@
-# Экзаменнационное задание по Основам веб-технологий
-Выполнил: Деев Егор Викторович, студент группы 241-327
+# WorldLang
-Выше представлен код моего проекта в качестве онлайн-школы иностранных языков. Также с моим проектом вы можете ознакомиться на сайте [lang.deev.su](https://lang.deev.su/) (сайт на https с API, работающим с переменным успехом).
+**Русский** · [English](README.en.md)
+
+[](https://github.com/EDeev/webdev-exam-2025-1-devik/actions/workflows/ci.yml)
+
+Экзаменационный проект по «Основам веб-технологий»: сайт онлайн-школы иностранных языков с каталогом
+курсов и репетиторов, заявками, личным кабинетом и картой учебных ресурсов на учебном API.
+
+**Статус:** учебный проект (Московский Политех, группа 241-327, экзамен, январь 2026), завершён, в архиве ·
+сайт — [lang.deev.su](https://lang.deev.su) (учебный API доступен не всегда)
+
+
+
+**Стек:** HTML5 · CSS3 · JavaScript (ES6+, fetch) · Bootstrap 5 · API Яндекс.Карт
+
+- Каталог курсов и репетиторов с поиском, фильтрами и пагинацией
+- Оформление заявки с расчётом стоимости, выбором даты и времени
+- Личный кабинет: просмотр, правка и удаление заявок
+- Карта учебных ресурсов (Яндекс.Карты) со списком мест
+- Данные из API экранируются перед вставкой в страницу (`esc()` в `js/utils.js`)
+
+## Запуск
+
+Сайт статический. На [lang.deev.su](https://lang.deev.su) nginx отдаёт файлы и проксирует учебный API
+по адресу `/api`. Для запуска с диска поставьте в `js/api.js` полный адрес API (указан там в
+комментарии) и откройте `index.html`.
+
+Проверки: `node --check js/*.js` и `npx htmlhint *.html` (правила — в `.htmlhintrc`, их же гоняет CI).
+
+## Лицензия
+
+Учебный проект (Основы веб-технологий, Московский Политех, 2025/26). Код открыт для изучения, отдельной
+лицензии нет.
+
+## Автор
+
+**Деев Егор Викторович** — [GitHub](https://github.com/EDeev) · [Telegram](https://t.me/DeevEgor) · [egor@deev.space](mailto:egor@deev.space)
+
+---
+
+
+
⭐ Если проект оказался полезным, поставьте звёздочку на GitHub!
+
Сделано с ❤️ — deev.space
+
diff --git a/docs/screenshots/main.png b/docs/screenshots/main.png
new file mode 100644
index 0000000..2881053
Binary files /dev/null and b/docs/screenshots/main.png differ