Wikiprojekt:Informatyka/Zalecenia edycyjne - Języki programowania

Poniżej znajdują się zalecenia edycyjne dla artykułów poświęconych językom programowania.

Elementy artykułuEdytuj

InfoboxEdytuj

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}}

WprowadzenieEdytuj

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.

HistoriaEdytuj

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ściEdytuj

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.

ZastosowaniaEdytuj

Szablon:Sztuka martwaArtykuł 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.

KrytykaEdytuj

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ładEdytuj

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

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ętrzneEdytuj

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 kwestieEdytuj

  • 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.