Comments 30
спасибо вам большое. действительно, русская локализация очень качественная.
К сожалению, тут php.net имеет довольно скудную и не совсем правильную документацию для начинающих.
Нужно что-то такое:
PHP начинающим:
- Что такое?
- Как работает? (азы клиент-серверной архитектуры)
- Как установить? (простейшие инструкции)
- Как написать Привет миру? (азы языка)
- Как написать форму обратной связи (показать клиент-серверный пример, смешивание php+html, глобальные переменные, валидацию параметров и функции)
- Как написать конвертер температуры (чтение из CSV, циклы, отображение таблицы, запись в файл)
- Счетчик посещений (работа с cookie, MySQL, GD)
Это все практические примеры, с которыми сталкиваются все программисты. Каждая инструкция в коде должна быть кликабельна, со ссылкой на полный мануал.
Цель документации не научить программировать, а предоставить понятную, непротиворечивую информацию о языке, его особенностях, функциях и т.д.
То, о чем пишите вы, это обучение. Курсов, учебников, тематических форумов по PHP в сети — огромное количество.
Я не путаю понятия документация и обучение. Я считаю их неразделимыми. Цель документации как раз и состоит в обучении.
Человек обращается к документации для того, чтобы изучить, как работает та или иная функция языка. Новичок же обращается к документацию с целью освоения программирования на PHP. Это как раз именно то место, где нужно показывать и объяснять правильный подход к разработке, философию и методологию.
Не совсем понятно зачем?!
Помимо всего прочего это еще и хорошая тренировка навыков переводчика.
К тому же отличный способ поддержать интеллектуальный тонус.
А реальное ли переехать с переводом на более удобный сервис, например transifex?
К тому же не уверен, что на подобной универсальной площадке возможно реализовать специфичные для этого проекта вещи.
А он ведь еще и не денег хочет вроде?
Слышал, что есть системы автоматизированного перевода. Т.е. переводишь предложение в файле, а система сама ищет вхождение этого предложения во всех файлах и переводит его.
Отличная задумка!
Когда патч висит в ожидании уже около двух недель без какого либо фидбека, то желание продолжать что либо делать пропадает напрочь. Собственно меня в тот момент спасло то, что 100 страниц — это не 5 страниц
У меня как-то так и получилось. После одной из статей о переводе перевёл и я пару страниц на пару языков на пробу, а потом пару недель никакой реакции, и непонятно, то ли я что-то неправильно сделал, то ли нет там никого. Потом ответил кто-то, перевод приняли, когда я уже и забыл об этом.
Есть еще один неудобный момент — многие забывают сформировать патч. Т.е. что-то переведут и ждут. Поэтому кроме патчей приходится просматривать и гораздо более объемный раздел «файлы в работе» и, если находится перевод недельной+ давности, то «делать вывод», что скорее всего просто забыли как патч оформить и делать это самостоятельно.
А можно попробовать в упрощенном варианте поработать 1-ой десятой землекопа, но через github? Насоздавать там issues и народ и я в том числе будет помогать в силу возможностей?
А вы зная уже весь процесс будете проталкивать изменения дальше в систему?
И снова о переводе документации PHP