Improve repo navigation and add MkDocs Pages site

Author: JavaJub

.gitignore

@@ -0,0 +1,2 @@
+site/
+.DS_Store

CONTRIBUTING.md

@@ -1,18 +1,46 @@
 # Как помочь проекту
 
-Гайды собираются вручную по реальным собеседованиям. Дополнения и исправления приветствуются.
+Гайды собираются вручную по реальным Java-собеседованиям. Дополнения, исправления и новые вопросы приветствуются.
+
+[← На главную](README.md) · [Канал JavaJub](https://t.me/+6GwSVWu9VIxlN2Yy)
 
 ## Что можно прислать
 
-- Новый вопрос с собеса в одну из компаний (с короткой подсказкой-ответом).
-- Уточнение или исправление в существующем ответе.
-- Гайд по новой компании.
+- Новый вопрос с собеседования в одну из компаний.
+- Короткую подсказку-ответ к существующему вопросу.
+- Уточнение формулировки, если ответ устарел или звучит неточно.
+- Гайд по новой компании или роли.
+- Практическую задачу: live-coding, SQL, code review, System Design.
+
+## Как оформить вопрос
+
+Держите стиль проекта: вопрос должен быстро помогать повторить тему перед интервью.
+
+```markdown
+- **Что будет, если hashCode() всегда возвращает одну константу?**
+  _Все ключи попадут в один bucket. В Java 8+ при достаточном размере таблицы bucket treeify, но производительность всё равно деградирует._
+```
 
-## Как оформить
+Правило: **короткая подсказка + практический пример**. Не нужно переписывать учебник; лучше дать ключевые слова, ловушку и production-последствие.
+
+## Источники и актуальность
+
+- Если вопрос был на вашем собеседовании, укажите компанию, грейд, примерную дату и стек.
+- Если информация взята из вакансии или публичного источника, добавьте ссылку.
+- Если факт может устареть, пишите дату: “актуально на апрель 2026”.
+
+## Pull Request
 
 1. Форкните репозиторий и создайте ветку.
-2. Правьте файлы в `guides/`. Держите стиль: вопрос — пунктом списка, подсказка — короткой строкой курсивом под ним (5–30 слов).
-3. Код — в блоках с указанием языка (```java, ```sql).
-4. Откройте Pull Request с кратким описанием, что изменили.
+2. Правьте файлы в `guides/`, `tasks/`, `roadmaps/` или навигационные страницы.
+3. Используйте кодовые блоки с языком: `java`, `sql`, `yaml`, `bash`.
+4. Проверьте, что ссылки открываются и таблицы корректно рендерятся.
+5. Откройте Pull Request с кратким описанием изменений.
+
+## Стиль
 
-Спорные формулировки лучше сперва обсудить в Issues.
+- Пишите по-русски, просто и инженерно.
+- Не делайте ответы слишком длинными: цель — подготовка к собеседованию, а не полноценный учебник.
+- Для блоков советов используйте Markdown-цитаты: `> **СОВЕТ.** ...`, `> **ВНИМАНИЕ.** ...`, `> **ФИШКА.** ...`.
+- Сначала корректность, потом красивость формулировки.
+- Если есть сомнения, откройте Issue и обсудите формулировку.

LICENSE

@@ -4,7 +4,7 @@ Copyright (c) JavaJub
 
 Этот материал распространяется по лицензии Creative Commons Attribution 4.0 International. Вы можете свободно копировать, распространять и адаптировать материалы при условии указания авторства.
 
-Указание авторства: JavaJub, https://t.me/java_jub
+Указание авторства: JavaJub, https://t.me/+6GwSVWu9VIxlN2Yy
 
 Полный текст лицензии: https://creativecommons.org/licenses/by/4.0/legalcode
 Краткое описание: https://creativecommons.org/licenses/by/4.0/deed.ru

README.md

@@ -1,50 +1,81 @@
-# Вопросы для собеседования Java — разборы по компаниям
+# Java interview guides by JavaJub
 
-Подготовка к техническим интервью Java-разработчика: вопросы, задачи, live-coding и реальные кейсы с собеседований в конкретные компании. Каждый гайд собран под стек и формат отбора отдельной компании.
+Реальные вопросы для Java-собеседований по компаниям: Java Core, Spring Boot, SQL, Kafka, JVM, многопоточность, live-coding, code review и System Design. Проект помогает быстро понять, что именно повторять перед интервью в Сбер, Альфа-Банк, VK, Яндекс, Т1, МТС и другие команды.
 
-[![Telegram](https://img.shields.io/badge/Telegram-JavaJub-2CA5E0?logo=telegram&logoColor=white)](https://t.me/java_jub)
+[![Telegram](https://img.shields.io/badge/Telegram-JavaJub-2CA5E0?logo=telegram&logoColor=white)](https://t.me/+6GwSVWu9VIxlN2Yy)
+[![GitHub Pages](https://img.shields.io/badge/Docs-GitHub%20Pages-222?logo=github)](https://javajub.github.io/java-interview/)
+[![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](LICENSE)
+
+> Новые разборы собеседований и свежие вопросы сначала выходят в Telegram-канале [@java_jub](https://t.me/+6GwSVWu9VIxlN2Yy). GitHub — бесплатная база, которую удобно читать, искать и дополнять.
+
+## С чего начать
+
+| Если вы готовитесь к... | Откройте |
+|---|---|
+| Java Junior | [маршрут Junior](roadmaps/java-junior.md) · [ITK Academy](guides/itk-academy.md) · [SberSeasons](guides/sber-internship.md) |
+| Java Middle | [маршрут Middle](roadmaps/java-middle.md) · [Сбер](guides/sber.md) · [Альфа-Банк](guides/alfa-bank.md) · [Лига](guides/liga.md) |
+| AQA Java | [маршрут AQA](roadmaps/java-aqa.md) · [МТС Банк AQA](guides/mts-bank-aqa.md) |
+| Банковский backend | [Сбер](guides/sber.md) · [Альфа-Банк](guides/alfa-bank.md) · [Т1 Иннотех](guides/t1-innotech.md) · [Лига](guides/liga.md) |
+| BigTech / алгоритмы | [VK](guides/vk.md) · [Яндекс Путешествия](guides/yandex-travel.md) |
+| Повторение по темам | [индекс тем](TOPICS.md) |
 
 ## Гайды по компаниям
 
-| Компания | Грейд | Стек |
+| Компания | Грейд | Фокус интервью |
 |---|---|---|
-| [Сбер](guides/sber.md) | Java Middle | JavaCore · JVM · Collections · Multithreading · Spring · SQL · System Design |
-| [Сбер — стажировка SberSeasons](guides/sber-internship.md) | Стажировка SberSeasons (Java Trainee) | Java Core · ООП · Коллекции · SQL · Алгоритмы · Spring · Git |
-| [Альфа-Банк (Alfa Digital)](guides/alfa-bank.md) | Java Middle | Java 11+ · Spring Boot · Kafka · PostgreSQL · Docker · Kubernetes · JUnit · Microservices |
-| [Т1 Иннотех](guides/t1-innotech.md) | Java Junior/Middle | Java · Spring Boot · Hibernate · PostgreSQL · Kafka · Docker · Microservices |
-| [VK (группа балансеров, One-cloud)](guides/vk.md) | Java Middle | Java 21 · Spring Boot 3 · Kafka · PostgreSQL · Kubernetes · gRPC · HAProxy · Docker |
-| [Яндекс Путешествия](guides/yandex-travel.md) | Java Middle | Java · Kotlin · Spring Boot · PostgreSQL · YDB · gRPC · Logbroker · Kubernetes |
-| [МТС Банк](guides/mts-bank-aqa.md) | AQA Java (Junior) | Java · Rest Assured · JUnit 5 · PostgreSQL · Kafka · WireMock · Allure |
-| [ITK Academy](guides/itk-academy.md) | Java Junior | Java · Spring · Spring Boot · Docker · SQL · Git · OAuth |
-| [Лига Цифровой Экономики](guides/liga.md) | Java Middle | Java 11+ · Spring · Hibernate · PostgreSQL · JUnit · Docker · Jenkins |
+| [Сбер](guides/sber.md) | Java Middle | Java Core, JVM, Collections, Multithreading, Spring, SQL, System Design |
+| [Сбер — стажировка SberSeasons](guides/sber-internship.md) | Java Trainee | Java Core, ООП, коллекции, SQL, алгоритмы, Spring, Git |
+| [Альфа-Банк (Alfa Digital)](guides/alfa-bank.md) | Java Middle | Spring Boot, Kafka, PostgreSQL, Docker, Kubernetes, JUnit, микросервисы |
+| [Т1 Иннотех](guides/t1-innotech.md) | Java Junior/Middle | Spring Boot, Hibernate, PostgreSQL, Kafka, Docker, code review |
+| [VK](guides/vk.md) | Java Middle | Java 21, Spring Boot 3, Kafka, PostgreSQL, Kubernetes, gRPC, алгоритмы |
+| [Яндекс Путешествия](guides/yandex-travel.md) | Java Middle | Java/Kotlin, Spring Boot, PostgreSQL, YDB, алгоритмы, System Design |
+| [МТС Банк](guides/mts-bank-aqa.md) | AQA Java Junior | Rest Assured, JUnit 5, PostgreSQL, Kafka, WireMock, Allure |
+| [ITK Academy](guides/itk-academy.md) | Java Junior | Java, Spring, Spring Boot, Docker, SQL, Git, OAuth |
+| [Лига Цифровой Экономики](guides/liga.md) | Java Middle | Java 11+, Spring, Hibernate, PostgreSQL, JUnit, Docker, Jenkins |
 
-## Разборы задач (code review)
+Более компактная матрица есть в [companies.md](companies.md).
 
-Реальные задачи с собеседований с пошаговым разбором кода.
+## Разборы задач
 
 | Задача | Формат |
 |---|---|
-| [X5 Tech · Senior — 8 багов в сервисе расчёта скидок](tasks/x5-blackfriday-code-review.md) | разбор кода под Senior |
+| [X5 Tech · Senior — 8 багов в сервисе расчёта скидок](tasks/x5-blackfriday-code-review.md) | code review, concurrency, production thinking |
+
+## Подготовка по времени
 
-## Что внутри каждого гайда
+| Срок | Что делать |
+|---|---|
+| 3 дня | Выберите 1–2 релевантных гайда, пройдите чек-листы, повторите HashMap, equals/hashCode, Stream API, Spring DI, SQL JOIN/индексы. |
+| 7 дней | Добавьте live-coding, 20–30 задач Easy/Medium, повторите транзакции, Kafka, JMM, Docker/Kubernetes по стеку вакансии. |
+| 14 дней | Пройдите маршрут по грейду, соберите ответы на поведенческие вопросы, потренируйте mock interview и разбор кода вслух. |
 
-- Как устроен отбор в компании и из каких этапов состоит.
-- Стек и темы, которые спрашивают именно здесь.
-- Вопросы с короткими подсказками-шпаргалками — Java Core, JVM, коллекции, многопоточность, Spring, SQL, базы данных, микросервисы, тестирование.
-- Практические задачи уровня собеседования с разбором решений.
-- System Design и поведенческая секция, где они есть.
-- Финальный чек-лист готовности и план подготовки.
+## Что внутри
+
+- Формат отбора и типовые этапы интервью.
+- Стек и темы, которые спрашивают именно в этой компании.
+- Вопросы с короткими подсказками-шпаргалками.
+- Практические задачи, live-coding, SQL и code review.
+- System Design и поведенческие вопросы там, где они встречаются.
+- Финальный чек-лист готовности.
 
 ## Как пользоваться
 
-Открывайте гайд по нужной компании, идите по разделам сверху вниз. Подсказки под вопросами — это не учебник, а шпаргалка: вспоминаете ответ по ключевым словам, а не учите с нуля. За день-два до собеса проходите финальный чек-лист.
+Откройте гайд по нужной компании и идите сверху вниз. Подсказки под вопросами — это не учебник, а быстрый способ вспомнить ответ по ключевым словам. Если собеседование уже близко, сначала пройдите финальный чек-лист и задачи.
+
+Это русскоязычная база для подготовки к Java собеседованию, но она также закрывает типовые поисковые темы: Java interview questions, Java Middle interview, Spring Boot interview questions, Kafka interview, SQL interview и live coding Java.
+
+## Как помочь
+
+Если у вас был реальный Java-собес, можно прислать вопросы через Issues или Pull Request. Особенно ценны: компания, грейд, стек, формат live-coding, вопросы по Java/Spring/SQL/Kafka и что оказалось неожиданным.
+
+Правила оформления — в [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## Канал
 
-Гайды берутся из Telegram-канала **JavaJub**. Там разборы выходят первыми, плюс свежие вопросы с собесов, задачи и обсуждения: [@java_jub](https://t.me/java_jub).
+Гайды берутся из Telegram-канала **JavaJub**. Там разборы выходят первыми, плюс свежие вопросы с собесов, задачи и обсуждения: [@java_jub](https://t.me/+6GwSVWu9VIxlN2Yy).
 
 Если материал пригодился — поставьте звезду, так его найдут другие.
 
 ## Лицензия
 
-Контент распространяется по [CC BY 4.0](LICENSE): можно делиться и использовать с указанием авторства (JavaJub, https://t.me/java_jub).
+Контент распространяется по [CC BY 4.0](LICENSE): можно делиться и использовать с указанием авторства (JavaJub, https://t.me/+6GwSVWu9VIxlN2Yy).