Contribution

Ми підтримуємо мінімалістичний підхід до розробки. Зрозуміла архітектура та чистий код важливіші за надмірну документацію всередині функцій.

Початок роботи

Форкніть та клонуйте репозиторій

git clone https://github.com/ModusTeam/cinema-platform-docs.git
cd cinema-platform-docs

Встановіть залежності
Terminal window
```
bun install
```
Запустіть dev-сервер
Terminal window
```
bun dev
```
Створіть гілку для своїх змін

Дотримуйтесь конвенції іменування (див. нижче) та вносьте зміни лише у своїй гілці.

Конвенція іменування гілок

Назва гілки має чітко відображати суть змін. Використовуйте наступні префікси:

Префікс	Призначення	Приклад
`feat/`	Нова сторінка або функціональність	`feat/add-auth-guide`
`fix/`	Виправлення помилки або неточності	`fix/setup-typo`
`docs/`	Оновлення наявного контенту	`docs/update-architecture`
`chore/`	Технічні зміни (конфіг, залежності)	`chore/upgrade-starlight`

Стандарти контенту

Структура файлів

Усі статті зберігаються у src/content/docs/ у форматі .md або .mdx
Кожен файл обов’язково має frontmatter з title та description
Для інтерактивних елементів (Steps, Tabs, Aside) використовуйте .mdx

// Функція без зайвих коментарів — назва говорить сама за себе
function calculateTotalPrice(items: PricingItem[]): number {
  return items.reduce((sum, item) => sum + item.price, 0);
}

// Ця функція рахує загальну суму
// Приймає масив items
// Повертає число
function calculateTotalPrice(items: PricingItem[]): number {
  // Використовуємо reduce для ітерації
  return items.reduce((sum, item) => sum + item.price, 0); // додаємо ціну
}

Іменування

Змінні та функції: camelCase, іменники для змінних, дієслова для функцій (getUserById, seatCount)
Компоненти та класи: PascalCase (SeatLockingService, OrderCard)
Константи: SCREAMING_SNAKE_CASE (MAX_SEAT_LOCK_DURATION)
Файли: kebab-case для .md/.mdx (local-setup.mdx, database-schema.mdx)

Pull Request

Дотримуйтесь наступної структури опису PR:

## Що змінено
Коротко - 1-2 речення про суть змін.

## Чому
Контекст: яку проблему вирішує або яку задачу закриває цей PR.

## Checklist
- [ ] `bun run format` виконано
- [ ] Frontmatter присутній у всіх змінених файлах
- [ ] Зміни протестовано локально (`bun dev`)

Перед створенням PR

# Форматування (Biome)
bun run format

# Перевірка білду
bun run build

Форматування

Проєкт використовує Biome для форматування та лінтингу. Конфігурація знаходиться у biome.json. Запускайте форматування перед кожним комітом:

bun run format