Poprawki sekcji o WSL

[j4b6ski]

Trochę moich sugestii jak można rozwinąć sekcję o WSLu. Chociaż im więcej przy tym dłubię tym więcej zastanawiam się czy to jest faktycznie najlepsze podejście. Możliwe że warto byłoby dokładniej opisać różne alternatywy.
Nagrania są do lekkiej korekty, trzeba by też sprawdzić instrukcje na świeżym Windowsie.

[blazejosinski]

Jeżeli jest taka możliwość to prosiłbym o zaakceptowanie tych zmian. Kurs wisi online i jest trochę mylący - sam straciłem dość dużo czasu próbując przez niego przebrnąć pomagając aspirującemu olimpijczykowi z rodziny (na co dzień w ogóle nie używam Windowsa).
Jeżeli "nagrania są do lekkiej korekty" to nawet jeżeli nie ma czasu ich nagrywać ponownie to miałoby sens dodać tekstowy komentarz mówiący co trzeba zrobić inaczej.

CC @lduraj @tonowak
Przy okazji dziękuję za przygotowanie tych materiałów, są pomocne!

[tonowak]

@blazejosinski dzięki za uwagi, zerkniemy na to wkrótce.

[j4b6ski]

W myśl utrzymywania otwartej dyskusji dodałem trochę komentarzy czemu konkretnie uczepiłem się tam gdzie się uczepiłem.
Nie jestem przywiązany do konkretnych sformułowań które napisałem - tak jak zauważyłeś @greg19, sporo z nich jest zbyt skomplikowanych.
Natomiast chętnie dowiedziałbym się co myślisz na temat tych komentarzy.

[j4b6ski]

Spotkałem się wielokrotnie z komentarzami dotyczącymi "czy instalacja Linuxa nie popsuje mojego Windowsa" - jakaś wzmianka na ten temat jednak powinna się tu znaleźć

[greg19]

Może wystarczy dodać "sposób uruchomienia Linuxa na Windowsie", albo coś w tym stylu.

Nie używałbym słów "maszyna wirtualna" i "system plików" – są zbyt straszne. Cały fragment "i dobrze zintegrowana z Windowsowym systemem plików i wyświetlaniem okienek" według mnie nie jest potrzebny. Zdanie "Dzięki temu..." też na razie wygląda mi niepotrzebnie, myślę że można się obejść bez niego i dodać tylko kilka słów przy definicji WSL.

Tutaj można wspomnieć że WSL jest oficjalnym oprogramowaniem od Microsoft.

[j4b6ski]

Myślę że jakieś odniesienie do oficjalnych instrukcji troubleshootingu jednak powinno się tu znaleźć. Zawsze znajdzie się ktoś komu nie zadziała, nawet jeśli nie będzie to przydatne dla potencjalnego uczestnika to może będzie jeśli poprosi kogoś o pomoc.

[greg19]

Link do oficjalnej instrukcji brzmi git (ten pierwszy). Jednak nie jestem przekonany że osobie której nie uda się przejść przez pierwszy link uda się przejść przez drugi. Z tym linkiem do troubleshootingu mam podobne odczucie, ale może rzeczywiście jest w nim jakaś wartość.

[j4b6ski]

Instalacja WSL jednak ingeruje w system trochę bardziej niż zwykłego software'u - warto co najmniej wspomnieć, że nie instalujemy jakiegoś dziwnego czegoś od nie wiadomo kogo.

[greg19]

Myślę że osób które podążają za tym tutorialem raczej nie obchodzi to jak bardzo coś ingeruje w ich komputer. Patrz instalowanie sobie rootkita żeby pograć w LoLa.

Samo pierwsze zdanie jest na tyle krótkie że uważam że można zostawić, tylko może tam wyżej gdzie jest pierwsza wzmianka o WSL.

[j4b6ski]

"kompilator mingw" (co jest trochę mylnym nadużyciem, ale faktycznie ciężko to lepiej opisać bez wchodzenia w detale techniczne) jest zaskakująco trudny do zainstalowania - to zdanie jest zupełnie nieprzydatne dla początkujących (zobacz komentarz poniżej).

[greg19]

Myślę że podobnej długości zdanie powinno się znaleźć w sekcji "alternatywy". W moim odczuciu targetuje ono osoby które są bardziej ogarnięte i z jakiegoś powodu nie chcą korzystać z WSL. Oni potrzebują jedynie jakiegoś punktu zaczepienia, żeby wiedzieć co googlować, a nie konkretnych instrukcji. Tych mniej ogarniętych według mnie należy przekonywać do WSL.

[j4b6ski]

Uważam że jednak warto powiedzieć po co instalowaliśmy WSL i dlaczego to działa ze środowiskiem na windowsie.

Moja wzmianka o tym że "zastanawiam się czy to jest faktycznie najlepsze podejście" dotyczyła konkretnie tego punktu - skoro i tak korzystamy z IDE na windowsie to może zamiast instalować WSL na siłę to lepiej faktycznie pokierować jak zainstalować MinGW.

WSL jest szalenie użyteczny, ale może jest to zbyt dużo za szybko.

[greg19]

Według mnie sekcje "Wstęp" i "Środowisko programistyczne C++" już wystarczająco dobrze wyjaśniają o co chodzi.

[j4b6ski]

Tutaj jest widoczny problem z MinGW - raz że trzeba wiedzieć który projekt jest aktualny, dwa że trzeba wiedzieć co dokładnie zainstalować. Polecam spróbować przejść samodzielnie przez ten proces, żeby przekonać się jak bardzo nieoczywiste to jest. Można by oczywiście ustalić jakąś konkretną opcję do zasugerowania uczestnikom. Kiedyś instalowało się Code::Blocks który był zpaczkowany z MinGW i nie było takich problemów.

[greg19]

Nie jestem przekonany, że osobie której nie uda się zainstalować WSL uda się przejść przez ten proces. Myślę że jeżeli "instalacja WSL się nie powiedzie" to należy spróbować ponownie/inaczej, a nie zaczynać od nowa czegoś jeszcze trudniejszego.

[j4b6ski]

To jest świetna opcja która powinna pojawić się w kursie, co najmniej pod kątem osób które nie mają możliwości instalacj software'u w swoim komputerze. Z doświadczenia powiem że bardzo dużo początkujących osób korzysta faktycznie ze środowisk online - często ze sporo gorszych niż usaco.

[greg19]

Wspomnienie o kompilatorach online brzmi jak dobry pomysł. Chociaż nie używałbym w tym momencie kursu słów "testowanie losowego rozwiązania". Wywaliłbym drugie zdanie. Pierwsze zdanie i tak zaczyna się od "w ostateczności", więc widać że nie polecamy tej opcji.

[j4b6ski]

Poprawiony filmik wygląda super. Apeluję jednak żeby instrukcje zawrzeć także w formie tekstowej - jeśli przeszkadza wam "ściana tekstu" to można spróbować zrobić rozwijalną sekcję. Dzieci mają obecnie bardzo krótki attention span i filmiki w tutorialach potrafią bardzo odstraszać.

[greg19]

Myślę że same komendy to dobry pomysł, żeby nie musieć przepisywać.

[j4b6ski]

Jak wyżej do VSCode - co ustawiamy i po co?

[greg19]

Ditto

[greg19]

Ja bym poklasyfikował czytelników tej lekcji na dwie grupy: taką która coś już sama programowała i taką, która nie.

Pierwsza grupa potrzebuje jak najprostszego wytłumaczenia – trudne słowa takie jak "maszyna wirtualna" albo "terminal" będą ich odstraszać. Taka osoba – która wchodzi na pierwszą lekcję programowania celem napisania Hello World – może się czuć że jest głupia, jeżeli nie będzie rozumieć 30% objętości tekstu. Dla niektórych może to być nawet na tyle zniechęcające, że pomyślą że programowanie nie jest dla nich i zrezygnują z takiej ścieżki kariery – nawet jeżeli są to nieliczne przypadki, nadal warto o nich myśleć.

Druga grupa (jeżeli w ogóle będzie przechodzić przez ten tutorial) pewnie będzie bardziej ogarnięta technologicznie, więc nie potrzebuje jakiś obszernych wyjaśnień. Jak będą potrzebować, to raczej będą w stanie sami znaleźć odpowiedź na swoje problemy.

Jeżeli tutorial będzie napisany jak dla osoby mniej ogarniętej niż ta która faktycznie go czyta, to nic się nie stanie. Jak będzie na odwrót, to już może mieć negatywne skutki. W związku z tym uważam że akurat ta część kursu powinna być szczególnie jak najprostsza.

[greg19]

Link do oficjalnej instrukcji brzmi git (ten pierwszy). Jednak nie jestem przekonany że osobie której nie uda się przejść przez pierwszy link uda się przejść przez drugi. Z tym linkiem do troubleshootingu mam podobne odczucie, ale może rzeczywiście jest w nim jakaś wartość.

[greg19]

Na pewno nie używałbym słów "terminal" i nie wspominał o uname – są zbyt straszne. Wpisywanie wsl w prompt też brzmi jak coś co nie będzie przydatne piętnastolatkowi.

Co do wspomnieniu o samym odpaleniu terminala, my pokazujemy setup w którym nie jest to potrzebne. Dociekliwy czytelnik, który chce zrobić coś więcej niż w naszych filmikach, raczej ogarnie że to się tak robi i nie trzeba tym nieogarniętym dodawać dodatkowego tekstu do sparsowania.

[greg19]

Nie jestem przekonany, że osobie której nie uda się zainstalować WSL uda się przejść przez ten proces. Myślę że jeżeli "instalacja WSL się nie powiedzie" to należy spróbować ponownie/inaczej, a nie zaczynać od nowa czegoś jeszcze trudniejszego.

[greg19]

Wspomnienie o kompilatorach online brzmi jak dobry pomysł. Chociaż nie używałbym w tym momencie kursu słów "testowanie losowego rozwiązania". Wywaliłbym drugie zdanie. Pierwsze zdanie i tak zaczyna się od "w ostateczności", więc widać że nie polecamy tej opcji.

[greg19]

Ditto

[greg19]

Myślę że same komendy to dobry pomysł, żeby nie musieć przepisywać.

[greg19]

Myślę że podobnej długości zdanie powinno się znaleźć w sekcji "alternatywy". W moim odczuciu targetuje ono osoby które są bardziej ogarnięte i z jakiegoś powodu nie chcą korzystać z WSL. Oni potrzebują jedynie jakiegoś punktu zaczepienia, żeby wiedzieć co googlować, a nie konkretnych instrukcji. Tych mniej ogarniętych według mnie należy przekonywać do WSL.

[greg19]

Myślę że osób które podążają za tym tutorialem raczej nie obchodzi to jak bardzo coś ingeruje w ich komputer. Patrz instalowanie sobie rootkita żeby pograć w LoLa.

Samo pierwsze zdanie jest na tyle krótkie że uważam że można zostawić, tylko może tam wyżej gdzie jest pierwsza wzmianka o WSL.

[greg19]

Może wystarczy dodać "sposób uruchomienia Linuxa na Windowsie", albo coś w tym stylu.

Nie używałbym słów "maszyna wirtualna" i "system plików" – są zbyt straszne. Cały fragment "i dobrze zintegrowana z Windowsowym systemem plików i wyświetlaniem okienek" według mnie nie jest potrzebny. Zdanie "Dzięki temu..." też na razie wygląda mi niepotrzebnie, myślę że można się obejść bez niego i dodać tylko kilka słów przy definicji WSL.

Tutaj można wspomnieć że WSL jest oficjalnym oprogramowaniem od Microsoft.

[greg19]

Zbyt techniczne