PHP/Inne/Dla twórców podręcznika: Różnice pomiędzy wersjami

Usunięta treść Dodana treść
Zyx (dyskusja | edycje)
m aktualizacja wytycznych
Zyx (dyskusja | edycje)
poprawka nawigacji + wytyczne dot. doboru bibliotek
Linia 1:
{{prognaw|PHP|[[../Inne:Autorzy/|Autorzy]]|}}
 
== Dla twórców podręcznika ==
Linia 53:
=== Neutralny punkt widzenia ===
Zgodnie z zasadą Wikibooks, podręcznik powinien utrzymany być w konwencji ***neutralnego punktu widzenia***. Dotyczy to w szczególności takich rozdziałów, jak [[PHP/Inne/Edytory PHP|Edytory PHP]] czy [[Programowanie:PHP:Inne:Pomoc|Pomoc]], które wcale nie służą do reklamowania własnych aplikacji bądź serwisów WWW. Wszelkie kontrowersyjne materiały będą usuwane albo przeredagowane bardzo szybko.
 
=== Dobór bibliotek ===
 
W podręczniku, oprócz PHP, omawiane są też wybrane biblioteki programistyczne stworzone w tym języku. Ponieważ bibliotek jest dużo, a tylko niektóre z nich trzymają odpowiedni poziom, utworzony został zbiór warunków, jakie biblioteka musi spełnić, aby mogła być omówiona w podręczniku w trosce o jego jakość.
 
# ''Obecność infrastruktury internetowej'' - system kontroli wersji, bugtracker, forum dla użytkowników
# ''Przynajmniej rok aktywnego rozwoju'' - w ciągu roku od pojawienia się podręcznika biblioteka musi być cały czas aktywnie rozwijana (nowe wersje, poprawianie błędów, nowa funkcjonalność). Podstawą jest aktywność w repozytorium SVN lub innego systemu kontroli wersji.
# ''Dostępne wydanie stabilne'' - biblioteka musi mieć przynajmniej jedno wydanie stabilne (tzw. wersja 1.0) aby mogła być umieszczona w podręczniku
# ''Dostępna kompletna dokumentacja'' - biblioteki bez dokumentacji lub jedynie ze szczątkową dokumentacją (np. wygenerowany minimalistyczny APIDoc) nie mogą być umieszczone w podręczniku.
# ''Wsparcie dla PHP 5.2/PHP 5.3'' - biblioteka musi ''bezproblemowo'' pracować na podanych wersjach PHP.
# ''Konsultacja na stronie dyskusji podręcznika''
 
{{Uwaga|Rozdziały o bibliotekach niespełniających powyższych warunków będą '''usuwane'''!}}
 
Pamiętaj, że podręcznik przede wszystkim poświęcony jest PHP. Rozdziały o bibliotekach mają jedynie pokazać zagadnienie i służyć za wstęp do danego tematu. Pełne omówienie biblioteki wykracza poza ramy tego podręcznika.
 
=== Podstrony ===