Переклад документації

Для коректної роботи з перекладом необхідно докладно ознайомитися з Керівництвом з розробки посібника з 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	пропуск

Обговорення можна проводити як тут, так і в списку розсилки doc-uk@lists.php.net