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