Wikiprojekt:Informatyka/Zalecenia edycyjne - Języki programowania
Poniżej znajdują się zalecenia edycyjne dla artykułów poświęconych językom programowania.
Elementy artykułu[edytuj | edytuj kod]
Infobox[edytuj | edytuj kod]
Opis każdego języka programowania musi być opatrzony infoboksem Język programowania infobox. Poniżej podany jest przykład infoboksu dla języka Erlang:
{{Język programowania infobox |nazwa = Erlang |logo = Erlang_logo.png |wielkość_loga = 250px |data = 1986 |paradygmat = [[Programowanie wieloparadygmatowe|wieloparadygmatowy]]: [[Programowanie funkcyjne|funkcyjny]], [[Programowanie współbieżne|współbieżny]] |typowanie = [[dynamiczna typizacja|dynamiczne]] ([[silna typizacja|silne]]) |wersja = R14B – {{Data wydania|2010|09|15}} |twórca = [[Ericsson]] |licencja = zmodyfikowana [[Mozilla Public License|MPL]] |platforma = [[wieloplatformowość|wieloplatformowy]] |system = [[wieloplatformowość|wieloplatformowy]] |www = http://www.erlang.org/ }}
Jeśli język nie posiada swojego loga, nie dodajemy tych parametrów.
Ponadto na końcu artykułu należy wstawić szablon Języki programowania:
{{Języki programowania}}
Wprowadzenie[edytuj | edytuj kod]
Wprowadzenie powinno zawierać krótki opis języka, jego podstawowe cechy oraz okoliczności powstania. Elementy, które muszą być uwzględnione:
- data powstania,
- kto stworzył,
- paradygmaty programowania (w szczególności czy jest to język imperatywny czy funkcyjny),
- tryb pracy: kompilowany, interpretowany, z maszyną wirtualną itd.
Historia[edytuj | edytuj kod]
Artykuł powinien posiadać sekcję opisującą powstanie i rozwój danego języka. W tym miejscu można posłużyć się źródłami pochodzącymi z oficjalnej strony projektu (młodsze języki prawie zawsze taką posiadają), a jeśli nie – warto poszukać w książkach mu poświęconych.
Możliwości[edytuj | edytuj kod]
Artykuł musi zawierać opis cech i możliwości danego języka, środków programowania udostępnionych programiście, paradygmatów itd. Forma jest dowolna – dopuszczalna jest zarówno lista, jak i bardziej rozbudowany opis z podziałem na sekcje.
Zastosowania[edytuj | edytuj kod]
Artykuł powinien opisywać zastosowania danego języka programowania, do jakich rodzajów aplikacji on się nadaje, gdzie jest wykorzystywany, czy specjalizuje się w rozwiązywaniu konkretnego rodzaju problemów. Jeśli znane są istotne wdrożenia (przez istotne rozumiemy np. jądro systemu operacyjnego czy jakaś popularna aplikacja), warto wymienić dwa lub trzy przykłady wraz z krótkim komentarzem.
Jeśli język był często używany w przeszłości, ale obecnie stracił na popularności, warto opisać przyczyny i opisać przeszłe zastosowania.
Krytyka[edytuj | edytuj kod]
Każdy język programowania posiada wady lub bywa przedmiotem krytyki ze strony części środowiska programistów. Dobrze napisany artykuł stanowczo powinien w sposób neutralny wymieniać i opisywać wady oraz stawiane zarzuty, wraz z odpowiednimi źródłami. Do dopracowania jest jeszcze kwestia tego, jakie źródła najlepiej wykorzystywać.
Przykład[edytuj | edytuj kod]
Artykuł powinien zawierać przykładowy, prosty program napisany w danym języku wraz z krótkim wyjaśnieniem, co on robi i jak. Można się postarać, by przedstawiał on jakąś kluczową własność języka.
Zobacz też[edytuj | edytuj kod]
W tej sekcji najważniejsze rzeczy to:
- główne kompilatory/implementacje,
- zagadnienia teoretyczne związane z danym językiem,
- paradygmaty programowania i inne artykuły związane ze sposobem działania danego języka.
Linki zewnętrzne[edytuj | edytuj kod]
Dopuszczalne odnośniki zewnętrzne:
- oficjalna strona projektu,
- dokumentacja/podręcznik użytkownika języka programowania,
- oficjalna polska strona języka, jeśli istnieje.
W szczególności nie linkujemy setek portali, blogów i w ogóle innych miejsc tylko dlatego, że pojawia się tam wzmianka o danym języku. Jeśli język posiada jakieś istotne odnośniki niepasujące do powyższych kategorii, najlepiej rozpatrzyć ich obecność na stronie dyskusji.
Dodatkowe kwestie[edytuj | edytuj kod]
- Więcej przykładów kodu źródłowego można oczywiście podawać, ale należy zachować pewien umiar. Jeśli 90% treści artykułu stanowić będą listingi bez słowa komentarza, na pewno zostanie on skierowany do całkowitego przeredagowania. Zalecane jest, aby listingi były tylko dodatkiem do merytorycznych opisów, a nie na odwrót.
- Wikipedia to nie kurs programowania – na szczegółowe omawianie składni, poszczególnych elementów wraz z przykładami użycia jest miejsce w projekcie Wikibooks.