Projekt jaki-jezyk-programowania.pl - ocena i feedback

Chciałbym przedstawić wam projekt, który tworzę wraz z dwójką znajomych - jaki-jezyk-programowania.pl. Jest to strona internetowa, która ma głównie na celu pomoc w wyborze języka programowania początkującym, ale też opisujemy dane technologie, tak by można je między sobą porównać. Do tego baza FAQ. Projekt jest w fazie rozwoju, pracujemy cały czas nad ulepszaniem strony i kontentu, który tworzymy głównie na podstawie informacji na forach, blogach czy stronach. Chcemy wszystko skupić w jedno miejsce i zapobiegnąć niezliczonej ilości pytań na ten temat. Może nie zniknie to całkowicie, ale odpowiedź wtedy będzie szybka ;).

Z tego też faktu, nie jesteśmy w stanie wszystkiego zweryfikować. Dlatego priorytetem jest dopracowanie kontentu. Bylibyśmy wdzięczni, gdyby osoby w temacie zerknęły na informacje na stronie i zgłosiły te nie aktualne/niepoprawne oraz to, co można by dodać.

Co do kodu to głównie interesuje nas poprawność formularza php do wysyłania maili. Jest to chyba napisane najprostszym sposobem, jaki się da. Zakładam więc, że są na to jakieś exploity, które nam zaspamią skrzynkę. Proszę jednak, aby nie testować ich na naszym formularzu :D, a zasugerować nam ewentualnie to, co powinniśmy zmienić/zabezpieczyć. Resztę też będziemy starać się refaktoryzować, więc code-review mile widziany.

Aktualnie strona oparta jest na statycznych plikach html, ale rozważamy inne rozwiązania, bo rozbudowa tego to będzie koszmar. Jeśli chodzi o design to raczej będą jakieś zmiany. Szczególnie strony o językach są wyjątkowo smutne. Mile widziane sugestie :).

Na stronie mamy także miejsce na przycisk typu donate (darowizny), jednak zastanawiamy się czy takie rozwiązanie w naszym przypadku ma sens. Nie mamy pojęcia czy w takich projektach jak nasz to się sprawdza, może są jakieś inne lepsze metody na wygenerowanie środków, chociażby do opłacenia serwera? Chętnie usłyszelibyśmy opinię osoby w temacie.

Gorąco zachęcamy do feedbacku! Czekamy na twoją opinię, która na pewno zmotywuje nas do dalszej pracy!

PS: Link do repozytorium na githubie znajduje się w sekcji o projekcie na stronie głównej.

nie jest źle, trochę grafika ssie i tutaj poszukałbym jakieś lepszej, może coś nowocześniejszego z wektorów co pasowałoby do layoutu strony
na głównej spore odległości pomiędzy sekcjami, tym bardziej że contentu mało więc jak dla mnie nie ma sensu robić tak dużych przerw co właściwie jedno zdanie
przycisk start na głównej u mnie jakoś tak dziwnie pływa przy przewijaniu, może inny gradient bym dał, lub po prostu png
FAQ jest dość ubogi, może jakieś cieniowanie dodać lub inną czcionkę, dodatkowo jak na nim jestem to nie za bardzo widać ten domek do powrotu na główną
warto też otworzyć np. w firefox źródło strony i wyświetla się na czerwono na co zwrócić uwagę w kodzie, bo tam jest kilka nieścisłości

Ogólnie całkiem ładnie, ale np. na tej podstronie: https://www.jaki-jezyk-programowania.pl/languages/java.html dodałabym 40px paddingu na dole niebieskiego boxa.

http://www.bestprogramminglanguagefor.me/ - wzór?

Na głównej stronie automat wypisuje na ekranie kody w różnych językach - żaden z nich nie jest należycie formatowany.

def divide(a, b): 
    if b == 0 return "Warning"
    else return a / b
print divide(15, 5)

Nie ładniej by było:

def divide(a, b): 
    if b == 0
        return "Warning"
    else
        return a / b

print divide(15, 5)

Pomijając fakt, że AFAIK (nigdy specjalnie w Pythonie nie pisałem) po if … powinien być :. Poza tym AFAIK Python 3 wymaga nawiasów przy print.

Desu napisał(a):

http://www.bestprogramminglanguagefor.me/ - wzór?

Czyli plagiat wykonany gorzej. Aż trzy osoby musiały przy tym pracować?

Nie wysyłajcie maili funkcją mail.

Nie podoba mi się kolorystyka. Głównie szary i ten #AA3939 kolor. Ale komputerek jest za to fajny.

https://validator.w3.org/nu/?doc=https%3A%2F%2Fwww.jaki-jezyk-programowania.pl%2F
https://validator.w3.org/nu/?doc=https%3A%2F%2Fwww.jaki-jezyk-programowania.pl%2Fstart.html

1. Jaka praca bardziej ci pasuje? -> przy interesującym startupie
2. Wolisz coś nowego?
   a) Tak -> Ruby & Python
   b) Nie, wolę coś sprawdzonego -> PHP

:D
Python - coś nowego :D

Panowie, wstyd.
Przeczytałem zakładki dotyczące tego samego języka na anglojęzycznym oryginale i u Was. Jestem pewien co do tego, że kopiowaliście zawartość (z ewentualnym zubożeniem jej), a dodatkowo nawet nie pofatygowaliście się na sensowne tłumaczenie, tylko google.translate. Wstyd. Jeśli nie macie pojęcia jak działa dany język, to zróbcie tymczasoso parę krótkic infomracji i adnotacje "strona w budowie", a nie taki prymitywny plagiat.

Dno. Za dużo grafiki, za mało tekstu (w zasadzie informacji co kot napłakał). Nie wiem, co się dzieje ze społeczeństwem, że coraz mniej treści a więcej grafiki/filmów. Na IE 11 laptop jest zupełnie w miejscu z tyłka i źle to wygląda... Kiepska wizytówka jak na "programistę"

Koncepcja ciekawa (pomysł). Nie wiem tylko po co 3 osoby do tego projektu - chyba że każdy ma po dwa etaty i trójkę dzieci w domu.

1. Nagłówek strony nie pasuje do strony (wizualnie)
2. Proszenie o wsparcie na tym etapie to jak proszenie o napiwek przed prezentacją samochodu w salonie

infografika jest lepsza, szybsza i ciekawsza niż coś takiego.

HEMIkr napisał(a):

Panowie, wstyd.
Przeczytałem zakładki dotyczące tego samego języka na anglojęzycznym oryginale i u Was. Jestem pewien co do tego, że kopiowaliście zawartość (z ewentualnym zubożeniem jej), a dodatkowo nawet nie pofatygowaliście się na sensowne tłumaczenie, tylko google.translate. Wstyd. Jeśli nie macie pojęcia jak działa dany język, to zróbcie tymczasoso parę krótkic infomracji i adnotacje "strona w budowie", a nie taki prymitywny plagiat.

Przecież to już zaznaczyliśmy na wstępie, z jakich źródeł jest brany kontent. Napisałem też co było naszą inspiracją. Gdzie ty widzisz tam jakiś google translate? Wszystkie informacje ręcznie pisaliśmy, posiłkując się różnymi źródłami. Nie wiem jakim cudem nie zauważyłeś informacji, że PROJEKT JEST W FAZIE ROZWOJU, która pojawia się na czerwono na głównej. Wszystkie teksy po kolei będziemy przeredagowywać i poprawiać wraz z pomocą społeczności. Na pierwszy ogień poszedł JavaScript. Ten sam wątek jest na forum Pasja Informatyki, możesz śledzić co się dzieje. Miło by było gdybyś też pomógł coś od siebie zamiast pisać "Wstyd", jakby tego było mało 2 razy.

Przydałoby się więcej języków.

Widzę, że na tym forum nie dostaniemy zbytnio pomocy z projektem, feedback co najmniej toksyczny tutaj, a czepianie się ilości osób, które tworzą projekt to już jest co najmniej śmieszne. Tak samo to, że istnieje już taka strona po ang i że niby robimy plagiat. Uważacie, że polskie community na tym nie skorzysta? Czy jak? Druga sprawa, to tamta strona jest dosyć uboga, a już jest dawno skończona. My ledwo co wystartowaliśmy w wersji pre alpha, no ale na tym forum chyba nie polecimy wyżej. Jeśli ktoś chce naprawę coś wnieść w rozwój strony to zachęcam do kontaktu.

Sama idea dla mnie nie ma sensu. Jeżeli chce coś zrobić to wybieram konkretne narzędzie a nie język. Sam fakt, że np. w Pythonie da się napisać grę nie oznacza od razu że gotowe narzędzia napisane w tym języku spełnią moje potrzeby. Języki programowania są bardzo podobne do siebie zatem wybiera się raczej narzędzia a nie język sam w sobie. Dlatego większy sens miałoby pytanie co chcesz zrobić i pokazanie narzędzi, np. chcesz zrobić grę oto gotowe silniki, ich cechy, czy mają edytor poziomów itp. Ale to wszystko można znaleźć na StackOverflow przecież.

Patrząc na to, co udostępniliście na GitHub to jesteście jeszcze na początku waszej przygody z programowaniem, z takim kodem daleko nie zajdziecie bo projekt będzie ciężki w utrzymaniu.

vpiotr napisał(a):

Proponuję jednak trochę pokory, bo granica między stanem "jestem zadowolony ze swojej roboty a oni się mylą" a stanem "po co mam się rozwijać, przecież jestem najlepszy" jest bardzo cienka. Poza tym reagując histerycznie na feedback nie robicie sobie dobrego PR.

Ale my chcemy własnie się rozwijać, a nie słuchać o tym ile osób to pisze czy to, że plagiaty czy inne nic nie wnoszące w projekt rzeczy. Wystarczy zobaczyć jak rozwija się feedback na drugim forum, które wcześniej linkowałem i widać różnicę.

Panowie - dużo wam daliśmy. Macie do poprawy stylistykę pisania bo ludzie twierdzą ze jak z Google translate. Dostaliście opinie o marginesach. Ze kiepsko dawać opcje donacji przy tej jakości i strona blednie działa na IE11... Jak chcecie pozytywnej opinii to poprawcie to i sprawcie ze strona będzie warta dobrej opinii.

Pod safari na iPhone tez są błędy. Menu przesłania wszystko poza klawiatura i gładzikiem latopa

Codeboy napisał(a):

HEMIkr napisał(a):

Panowie, wstyd.
Przeczytałem zakładki dotyczące tego samego języka na anglojęzycznym oryginale i u Was. Jestem pewien co do tego, że kopiowaliście zawartość (z ewentualnym zubożeniem jej), a dodatkowo nawet nie pofatygowaliście się na sensowne tłumaczenie, tylko google.translate. Wstyd. Jeśli nie macie pojęcia jak działa dany język, to zróbcie tymczasoso parę krótkic infomracji i adnotacje "strona w budowie", a nie taki prymitywny plagiat.

Przecież to już zaznaczyliśmy na wstępie, z jakich źródeł jest brany kontent. Napisałem też co było naszą inspiracją. Gdzie ty widzisz tam jakiś google translate? Wszystkie informacje ręcznie pisaliśmy, posiłkując się różnymi źródłami. Nie wiem jakim cudem nie zauważyłeś informacji, że PROJEKT JEST W FAZIE ROZWOJU, która pojawia się na czerwono na głównej. Wszystkie teksy po kolei będziemy przeredagowywać i poprawiać wraz z pomocą społeczności. Na pierwszy ogień poszedł JavaScript. Ten sam wątek jest na forum Pasja Informatyki, możesz śledzić co się dzieje. Miło by było gdybyś też pomógł coś od siebie zamiast pisać "Wstyd", jakby tego było mało 2 razy.

No niestety, ale strone postawiliście już na domenie ostatecznej, ma dostęp do szerokiej publiczności, więc wszelkie plagiaty lub "inspiracje" jak to określasz są absolutnie nie na miejscu. Już lepiej jakbyście użyli Lorep Ipsum, wtedy przynajmniej byłoby wiadomo, że to tekst tymczasowy. Przeredagowanie tekstu o długości 10 zdań do stanu takiego, żeby inspiracja nie była oczywista to robota na jakieś 10 min, więc nie wykręcajcie się też "wczesną fazą rozwoju".

Jako pomoc potraktuj uświadomienie jak bardzo źle widziane może być taka zagrywka.

Logo umieszczone w lewym górnym rogu wygląda źle:

• każda składowa loga jest w innym stylu - nazwa, pytajnik i obrazek zupełnie nie pasują do siebie,
• każda składowa loga posiada inny poziom antialiasingu (przy czym słówko programowania prawie wcale nie wygląda na wygładzone, przez co widać pikselozę na krawędziach liter),
• obrazek konsoli przykrywa połowę kropki,
• pomiędzy słowami Jaki i język jest zbyt mały odstęp,
• pomiędzy pierwszą linijką tekstu a drugą, odstęp jest zbyt duży,
• oryginalny rozmiar obrazka loga to 401x127 px, a na stronie jest pomniejszony (na siłę zmniejszona wysokość do 40px za pomocą styli w CSS, co daje około 30% oryginalnej wysokości);

Tyle bubli w jednym, głupim obrazku, które znacząco wpływają na estetykę strony;

@Codeboy: jak masz problem z grafiką to pobierz sobie program Inkscape - takie logo łatwo jest wyklikać; W tym programie możesz sobie stworzyć logo wektorowe, użyć dowolnego fontu, dodać gradienty, namalować konsolę; Na koniec wyeksportować do PNG w dowolnej wielkości, bo grafika wektorowa może być dowolnie skalowana, bez uszczerbku na jakości.

lukas_gab napisał(a):

Panowie - dużo wam daliśmy. Macie do poprawy stylistykę pisania bo ludzie twierdzą ze jak z Google translate. Dostaliście opinie o marginesach. Ze kiepsko dawać opcje donacji przy tej jakości i strona blednie działa na IE11... Jak chcecie pozytywnej opinii to poprawcie to i sprawcie ze strona będzie warta dobrej opinii.

Tu racja, ale bez was tego nie poprawimy, w tym rzecz. Bo zwyczajnie nie mamy aż tyle doświadczenia. W założeniu miałem, że będą wskazywane błędy, rzecz jasna, ale co konkretnie jest źle, dlaczego i jak powinno być poprawnie. Nie chcemy pozytywnej opinii. Jeśli takie sprawiłem wrażenie, to nie umyślnie. To co chcemy, to zbudować z waszą pomocą coś przydatnego dla początkujących, a przy tym wiele się nauczyć dla siebie.

PS: Co do donacji, to już się wyraziłem na ten temat wcześniej.

glitch:

1. jak najedziesz na napis np. JavaScript, Ruby, powiększa się powoli rozmiar liter, i to jest okej.
2. jednak gdy zjedziesz z napisu, zamiast powoli się powiększyć, napis od razu przeskakuje i staje się mały. wygląda to na "niedorobione".

Myślę, że wystarczyłoby tam dać proste transition, zamiast bawić się w animation.

@Codeboy a jakich rzeczy chcecie się w ten sposob nauczyc ?

Nie powinniście się brać za taki projekt nie mając doświadczenia w programowaniu - możecie wyrządzić więcej szkody niż pożytku doradzając innym początkującym. Mamy tu klasyczny przykład tego: https://pl.wikipedia.org/wiki/Efekt_Krugera-Dunninga

Garść uwag technicznych:

• zależności w repo? Poczytajcie o czymś takim jak npm lub od biedy Bower,
• proponuję używać jednak aktualnego standardu JS (ES6+),
• trzymanie html-a w zmiennych Js-owych to słaby pomysł (no chyba, że są to template strings - nie u Was),
• pobieracie elemnty DOM po kilka(naście) razy - chyba umiecie używać zmiennych??
• plik start JS to jakaś masakra - nie widzicie tych powtórzeń? Pojęcie funkcji też chyba znacie - zastosujcie je. Poza tym w JS nie trzeba deklarować wielkości tablicy, zamiast:

var arr = new Array(3);
arr[0] = 'foo';
arr[1] = 'bar';
arr[2] = 'baz';

pisze się (a raczej const zamiast var, ale już trzymajmy się ES5):

var arr = [
  'foo',
  'bar',
  'baz',
];

• sama koncepcja tych tablic też strasznie nieczytelna - ciężkie w rozbudowie, wszechobecne magic numbers itp
• formatowanie kodu też nie najlepsze - podepnijcie jakiegoś ESLinta czy coś podobnego ( https://github.com/feross/standard , https://github.com/airbnb/javascript),
• słaba modularyzacja i uporządkowanie kodu,
• o statycznych htmlach nie wspominam, bo sami widzicie, że to koszmar.

Maciej Cąderek napisał(a):

Nie powinniście się brać za taki projekt nie mając doświadczenia w programowaniu - możecie wyrządzić więcej szkody niż pożytku doradzając innym początkującym. Mamy tu klasyczny przykład tego: https://pl.wikipedia.org/wiki/Efekt_Krugera-Dunninga

Ale to nie my stricte doradzamy początkującym. My tylko zbudowaliśmy stronę, która teraz wraz z bardziej doświadczonymi poprawiamy, tak aby tych szkód właśnie nie wyrządzić. Takie było założenie od początku. Teraz głównie mamy na celu doprowadzenie kontentu i quizu do porządku. Jeśli byłyby osoby chętne do pomocy w przeredagowaniu info o językach, to bylibyśmy wdzięczni. Kilka osób w temacie w danych technologiach i treść o językach załatwiona Później przebudujemy stronę, tak aby była łatwiejsza do utrzymania dla nas, a potem ewentualny rozwój. Bo to raczej nie będzie dla Nas takie "hop siup". Na razie się w tym odnajdujemy.

Co do reszty uwag to na pewno skorzystamy, dzięki!

Codeboy napisał(a):

Ale to nie my stricte doradzamy początkującym. My tylko zbudowaliśmy stronę, która teraz wraz z bardziej doświadczonymi poprawiamy, tak aby tych szkód właśnie nie wyrządzić.

Strona merytorycznie jest teraz na bardzo niskim poziomie. Nawet jeśli znaleźlibyście osobo chętne pomóc Wam w poprawieniu jej jakości to macie jeden zasadniczy problem - to Wy zatwierdzacie pull requesty - w jaki sposób zweryfikujecie ich poprawność? Co zatwierdzić, co odrzucić? Co z okresem zanim teksty zostaną dopracowane? Strona jest już opublikowana i sieje dezinformację.

Co do reszty uwag - proszę bardzo!

C jest jednym z najstarszych i najszerzej używanym strukturalnym językiem programowania. Oznacza to, że nie wspiera programowania obiektowego (ang. object-oriented >programming).

Czyli z fakt, że jest najszerzej używany wynika, że nie wspiera OOP ?

Można powiedzieć ze jest mieszaniną wszystkich języków

Raczej jest sobą. To jeden z najmniej złożonych języków.

Używany jest do tworzenia oprogramowania systemowego i sprzętu (ang. hardware).

Tutaj mamy objaw "translatora" myślę. Po pierwsze, C jest językiem ogólnego przeznaczenia, a po drugie, w C się sprzętu nie tworzy - jak już to oprogramowanie sterujące sprzętem, a sam sprzęt tworzy się w VHDL czy Verilog.

Jest łatwo przenośny miedzy systemami

O ile napiszesz sobie kompilator - bardziej same programy w nim napisane są proste (lub możliwe) do przenoszenia między systemami.

C został użyty do stworzenia Amazon Kindle, jąder systemów operacyjnych takich jak Windows, Linux, Mac, iOS, Android, Windows Phone, systemów bazodanowych czy >biblioteki programistycznej do tworzenia grafik - OpenGL

Windows w dużej mierze to C++

C jest tak lekki i wydajny, że jest praktycznie w każdym systemie wbudowanym, od lodówek, mikrofalówek, zegarków do radia włącznie

Nie wiem, co robi tutaj to "że" - żeby miało to logiczny sens zamienił bym to na "z tego powodu"

Większy nacisk trzeba kłaść też na debugowanie kodu oraz szybko musisz nauczyć się o błędach pamięci

Dlaczego, w C więcej należy debuggować?

Wynika to z faktu, ze jest to język niskiego poziomu

C jest językiem wysokopoziomowym.

to znaczy ma najbliższy kontakt z maszyną

Eh... C jest językiem 3GL, bliżej sprzętu są Assemblery i są to języki 2GL, natomiast najbliżej sprzętu to języki maszynowe (raczej nie używa się pojęcia 1GL), więc machneliście się o 3 generacje ...

Chcąc pisać w C musisz mieć także dobrą znajomość architektury komputera oraz podstaw systemów operacyjnych

Jest to nam potrzebne, jeśli chcemy pisać oprogramowanie systemowe, lub jakieś embended ...Nie wiem po co to np. twórcą Gimpa

Nie illuminati sterują światem, a język C! C jest przeszłością, teraźniejszością i na ten moment można powiedzieć, że zostanie z nami w przyszłości.
0_o serio ?

Python ...

oraz znany wszystkim Gimp

Widzieliście kod Gimpa ? Np.

static void
export_add_alpha (gint32  image_ID,
                  gint32 *drawable_ID)
{
  gint32  nlayers;
  gint32  i;
  gint32 *layers;

  layers = gimp_image_get_layers (image_ID, &nlayers);
  for (i = 0; i < nlayers; i++)
    {
      if (!gimp_drawable_has_alpha (layers[i]))
        gimp_layer_add_alpha (layers[i]);
    }
  g_free (layers);
}

hmm... podobny do C ten Python.

Nie trzeba kłaść dużego nacisku na składnie jak w innych językach

Niby dlaczego ? Tak samo jak w innych (C,Java), gdy zrobisz błąd składni to się nie skompiluje. Tutaj dodatkowo masz większą restrykcję, bo znaczenie ma formatowanie kodu i białe znaki...

Python pozwala także na dowolność, tzn. nie ma sztywnych zasad tworzenia oprogramowania oraz wybacza więcej błędów

No z powyższego wynika, że wybacza mniej błędów.

Przez to, że Python jest dynamicznie pisanym językiem, komputer sprawdza kod w trakcie działania programu, co powoduje, że jest on dosć wolnym językiem

Kod nie jest sprawdzany, a interpretowany. Ciekawe jakie problemy wydajnościowe napotkaliście. Część bibliotek pythonowych jest skompilowana do C i jest to cholernie szybki - np. OpenCV, czy biblioteki do komunikacji z urządzeniami na FPGA

Dodatkową wadą jest fakt, że wraz z rozwojem aplikacji, staje się ona coraz trudniejsza do zarządzania oraz debugowania.

Nie widzę związku. Popatrz sobie na molochy w C# które mają po 10lat i 1milion linii kodu - zobaczysz co jest trudniejsze do zarządzania i debuggowania.

Generalnie pełno takich kwiatków i jak się czyta, że C jest niskopoziomowe lub służy do projektowania sprzętu, to o ile nie jest się początkującym to przestaje się traktować poważnie autorów, a początkujący są wprowadzani w błąd.