Гайд для спільноти
Як долучитись
до UA→JP
Довідник — це community-проєкт. Кожен може додати ресурс, виправити помилку, перекласти розділ або зробити code contribution. Ось як.01 · Ресурси
Додати ресурс (лікаря, ресторан, школу)
Якщо ви знаєте перевіреного лікаря з україномовним персоналом, хороший ресторан з дитячим меню, мовну школу або юриста, який допомагає іноземцям — додайте в каталог.
★Найшвидше: відкрийте сторінку ресурсів і натисніть кнопку «Додати ресурс». Заповніть коротку форму (назва, категорія, префектура, місто, контакти, опис). Модерація — 1-2 робочі дні.
Що підходить
- Лікарі / клініки з українською, російською або англійською мовою
- Ресторани / кафе з дитячим меню, vegan-friendly, безглютеновим
- Мовні школи для дорослих і дітей
- Юристи, податкові консультанти, бухгалтери для іноземців
- Церкви / релігійні громади
- Перукарі / барбери, автосервіси, репетитори
Що не підходить
- Бізнеси без фізичної адреси в Японії
- Платні послуги без чіткого прейскуранта
- Партнерські / affiliate-посилання (ми не просуваємо)
02 · Помилки
Повідомити про помилку
Знайшли застарілу ціну, неправильну адресу, неточну формулювання або бите посилання — будь ласка, повідомте.
★Найшвидше: напишіть у Telegram-чат @uajpguide — наша спільнота миттєво підтвердить і ми виправимо протягом 1-2 днів. Або створіть Issue на GitHub — для технічно підкованих.
Як описати помилку
Дайте максимум контексту — це прискорить виправлення:
- URL сторінки (наприклад,
uajp.guide/guide/finance#bank) - Що не так (застаріла ціна, неправильна назва, відсутній крок)
- Актуальна інформація (якщо є)
- Дата, коли помітили
03 · Контент
Додати контент (статтю, гайд, переклад)
Якщо ви хочете написати повноцінну статтю, додати новий розділ довідника, перекласти українською японську процедуру або поділитися своїм досвідом — це для вас.
01Письмовий контент українськоюНапишіть матеріал у Google Docs / Notion, поділіться посиланням у Telegram. Наша редакція перевірить факти, відредагує під стиль сайту та опублікує.
02Переклад з японської / англійськоїОфіційні джерела (MOJ, MHLW, NTA тощо) — це першоджерела. Якщо ви знайшли важливу процедуру японською, якої немає у нас — перекладіть і надішліть.
03Досвід з перших рук"Як я відкрив рахунок у JP Bank", "Мій шлях до 永住", "Як я віз тварину через AQS" — реальні кейси від спільноти дуже цінні. Можемо опублікувати як окремий блог-пост.
04Code of conduct — обов'язковоКонтент має бути фактично перевіреним, з посиланнями на офіційні джерела. Без російської чи іншої пропаганди. Див. розділ унизу.
04 · Code
Code contribution (GitHub)
Сайт — open-source на Next.js + TypeScript. Якщо ви знайомі з React / Next / CSS — можете зробити PR.
Швидкий старт
1. Fork репозиторійgithub.com/KonekoBuys/ukr-japan-guide/fork
2. Клонуй локально
git clone https://github.com/YOUR_USERNAME/ukr-japan-guide.gitcd ukr-japan-guide && npm install3. Створи гілку
git checkout -b fix/your-fix-name4. Зміни кодДотримуйся стилю:
app/globals.css — єдине джерело стилів, 2 пробіли, без Tailwind. TypeScript strict.5. Перевір локально
npm run dev — http://localhost:3000. Перевір на мобільному (responsive).6. Build & push
npm run build (має пройти без помилок).git commit -m "fix(scope): опис"git push origin fix/your-fix-name7. Створи Pull RequestНа GitHub — новий PR з описом змін і screenshot. Після review — merge.
Що можна зробити
- Виправлення багів (дивись issues)
- Покращення UX / accessibility
- Нові компоненти (RSS feed, dark mode, search improvements)
- SEO оптимізація (metadata, JSON-LD, structured data)
- i18n — додати англійську або японську версію
- Тести (зараз їх мало — можна додати)
05 · Фінансово
Підтримати фінансово
Донати йдуть на хостинг (Vercel), домен (Cloudflare) і розвиток довідника. Наразі ми зібрали 24 з 250 потрібних.
★Найпростіше: PayPal-посилання або банківський переказ (реквізити за запитом на [email protected]). Будь-яка сума — донат, разовий чи регулярний.
На що йдуть кошти
- Vercel Pro — $20/міс (production deploy, analytics, edge functions)
- Домен — ~$12/рік (uajp.guide через Cloudflare Registrar at-cost)
- Email — безкоштовно (Cloudflare Email Routing)
- Резерв — на розвиток (API, додаткові інструменти, переклади)
Усі транзакції — публічні. Звіт — на /support.
06 · Спільнота
Спільнота
Найактивніша частина UA→JP живе в Telegram. Приєднуйтесь!
Telegram-чат @uajpguideПитання, досвід, поради українською. Без реклами, без ботів. Модерація спільнотою.
GitHub Discussionsgithub.com/KonekoBuys/ukr-japan-guide/discussions — для довгих обговорень, feature requests, RFC.
GitHub Issuesgithub.com/KonekoBuys/ukr-japan-guide/issues — баги, неточності, технічні проблеми.
Email[email protected] — для приватних питань.
07 · Правила
Code of conduct
UA→JP — нейтральний community-проєкт для всіх українців у Японії. Щоб залишатись таким, ми дотримуємось простих правил.
✓Тільки перевірені фактиКожне твердження має джерело — офіційний сайт (MOJ, MHLW, NTA, RHQ тощо) або першоджерело. Без "казали знайомі" або "десь читав".
✓Без російської пропагандиUA→JP — про українців у Японії, не про російсько-українську війну. Політичні дискусії — у відповідних спільнотах, не у нас.
✓Повага до спільнотиБез образ, без дискримінації за мовою, статтю, національністю, статусом. Українська, російська, англійська — всі вітаються.
✗Без реклами без позначкиЯкщо ви пишете про платний сервіс — це має бути чітко позначено. Affiliate-посилання — лише до заздалегідь схвалених сервісів (див. AGENTS.md).
Цей довідник — волонтерський і не замінює офіційних джерел. Завжди перевіряйте інформацію перед прийняттям рішень. Якщо ви не згодні з якимось матеріалом — напишіть у спільноту, ми обговоримо і виправимо.