Для коректної роботи з перекладом необхідно докладно ознайомитися з Керівництвом з розробки посібника з PHP.
- Система контролю версій — Git, платформа — GitHub. Відповідно, щоб новачку якнайшвидше додати чи оновити файли, потрібно просто надіслати pull request. Після певної кількості підтверджених pull request-ів перекладач може отримати право на редагування сховища, попросивши про це команду документування.
- Документація ведеться в науковому стилі, файли документації написані мовою розмітки XML за певними правилами форматування.
Коли перекладач обрав файл, який необхідно перекласти, то на додаток до всіх приготувань, він змінює його статус на wip в коментарі EN-Revision,
<!-- EN-Revision: XXXXX Maintainer: YYYYY Status: wip -->
вивантажує цей файл в сховище і вже потім починає перекладати. WIP означає "Work in progress", тобто файл взятий в роботу. Таким чином запобігають випадкам, коли кілька перекладачів працюють над однаковим текстом.
Після коментаря EN-Revision слідує коментар Reviewed:
<!-- Reviewed: no -->
Значення no застосовується до щойно перекладених файлів. Значення yes застосовується до файлів, що були перевірені (вичитані) іншим перекладачем, який має право на редагування сховища.
Коментарі в блоках коду необхідно перекладати.
Important
Словник є неповним і недосконалим, тож вітається обговорення наявних та нових термінів. Українські відповідники, що вже викладені тут, є обов'язковими до застосування з метою спільного трактування.
| Англійською | Українською |
|---|---|
| argument | параметр |
| backslash | обернена коса риска |
| bootstrap file | файл ініціалізації |
| bug | вада |
| build | збірка, збирати |
| callable | назва виклику |
| conversion (про тип) | перетворення |
| cookies | куки |
| default | початковий/стандартний/типовий |
| debugger | зневаджувач/налагоджувач |
| directory | директорія |
| engine | рушій |
| enum(eration) | перелічення |
| exception | виключення |
| FAQ | ЧаПи (увага на регістри букв) |
| float | десятковий дріб/число з рухомою крапкою |
| folder | тека/каталог/папка |
| handl(-e, -er) | дескриптор, обробник |
| hash | геш |
| implement (про клас) | реалізовувати |
| instance (про клас) | примірник |
| (неіст.) name | назва |
| named | названий |
| to sort | впорядковувати |
| source code | початковий код |
| rollback | відкочува(-ння/ти) |
| runtime | середовище виконання/час виконання |
| whitespace | пропуск |