Dopiero zaczynam na poważnie przygodę z frameworkami PHP. Podchodziłem do tego tematu już parę razu ale jakoś brakowało samozaparcia do zmiany przyzwyczajeń. Zainteresowałem się frameworkiem Yii i zgłębianie go zacząłem od strony http://www.yiiframework.com/doc/guide/1.1/pl/index. Niestety im dłużej czytam ten przewodnik tym bardziej załamuje mnie jego poziom. Ilość błędów jest porażająca. Chwilami mam podejrzenia, że pewne fragmenty były tłumaczone jakimś automatem. Błędy są zarówno w kodach jak i treści. Dużo zdań jest bardzo niegramatycznie napisanych i ciężko jest zrozumieć co autor chciał przekazać. W wielu miejscach brakuje literek. Zdarzają się też całe bloki które nie mają sensu. Przed chwilą właśnie trafiłem na taki kwiatek i zdecydowałem się założyć konto na forum.
Strona http://www.yiiframework.com/doc/guide/1.1/pl/database.ar:
To samo na stronie http://www.yiiframework.com/doc/guide/1.1/en/database.ar:
Z polskiej wersji wynika, że autor będzie stosował notację wielbłąda choć później stwierdza, że jednak mądrą decyzją jest stosowanie notacji z małymi literami i podkreśleniami. W kodach kawałek dalej stosuje jednak notację z małymi literami czyli zaprzecza sobie.
Z ostatnich błędów jakie pamiętam to na stronie http://www.yiiframework.com/doc/guide/1.1/pl/database.dao autor myli skrót DSN z DNS. To nie jest błąd w jednym tylko miejscu. Autor konsekwentnie przekręca DSN na DNS. W angielskiej wersji wszystko jest jak trzeba.
Moim celem nie jest psucie reputacji tego projektu. Chciał bym pomóc w doprowadzeniu przewodnika do takiego poziomu, żeby nie trzeba było się za niego wstydzić. Mam dość duże doświadczenie w programowaniu w PHP więc dość łatwo wyłapuję błędy merytoryczne ale wiele osób mogło polec w nauce przez taki przewodnik. Proszę o informację gdzie lub do kogo można przesłać listę błędów w przewodniku tak aby stał się użyteczny dla wszystkich, zwłaszcza początkujących.