This is an old revision of the document!


Ghidul asistenților

Resurse folosite

    • conţine
      • scheletele laboratoarelor şi soluţiile lor
      • temele
      • codul generatorului de teste
      • alte lucruri utile
    • respectaţi formatul descris in readme-uri
  • folder partajat in google drive
    • link-uri către materialele de pe wiki (textele laboratoarelor ̧şi ale temelor)
    • pentru fiecare temă se crează un forum
    • ssh poo@elf.cs.pub.ro - puneți cheia publică în documentul de organizare ca să o adăugam pe poo@elf.
  • trello - pentru organizarea taskurilor

Laboratoare

  • Responsabilii de laboratoare trebuie să realizeze todo-urile din template-ul de pe trello. Ele sunt legate de mici corecturi legate de formatare dar și de exerciții sau exprimări. În 2020 o să păstrăm majoritatea exercițiilor nemodificate, le actualizăm/schimbăm doar pe cele neclare sau inutile.
  • Scheletul laboratorului (dacă există) trebuie adăugat şi în repository atunci când este publicat laboratorul
  • Soluţiile
    • trebuie să fie puse în repository în acelaşi timp cu scheletul
    • ar trebui să conţină comentarii care să explice studenţilor mecanismele utilizate
    • ar trebui să ofere javadoc si sa respecte coding style-ul
  • Dacă observați mici greșeli pe parcursul semestrului le puteți modifica direct. Dacă e ceva mai important/mai mult de schimbat atunci puteți să îl notați pe card-ul de trello al labului respectiv. * Link-ul la canalul de YouTube pentru videoclipurile explicative este acesta. Credenţialele pentru cont sunt următoarele: * e-mail: oop.cs.pub@gmail.com * parola: DristorIsLove69 ==== Sfaturi predare ==== (pe scurt, pentru mai multe info, ping Adriana on Slack) Pre-online (dar multe sunt inca aplicabile): * La POO nu diferă în totalitate materia de la lab vs cea de la curs (e.g. ca la pm, asc), deci ne bazăm că ei au auzit de noțiunile din lab de la curs, deci nu explicam jumătate de oră ca la alte materii, ci doar 10-15 min. * dacă durează prea mult ei se vor panica că nu vor termina exercițiile și se vor apuca de ele în timp ce vor vorbiți, ignorăndu-vă. * Explicațiile trebuie să fie cât mai engaging pentru studenți, încercați să îi atrageți în discuții, porniți eventual de la o problemă și să virați înspre cum se rezolvă cu noțiunile din laboratorul actual * exemple din real-world * problem-driven * nu trebuie menționat absolut tot din lab, eventual le mai explicați și în timpul exercițiilor * Le puteți permite să vă arate la laboratorul următor ce nu termină în laboratorul curent, dar nu acceptați să vedeți exerciții pe mail sau de la cineva care a lipsit. * Testele: * fiți punctuali și nu începeți laboratorul mai tarziu de :05 * discutați pe scurt soluția cu ei dupa test și înainte de a începe explicațiile laboratorului * evaluați-le până la urmatorul laborator..why? dacă observați că au făcut foarte mulți o anumită greșeala sau vedeți că nu au înțeles un concept, e bine sa mai insistati pe el, să îl mai explicați o data în următorul lab (E.g. vedeți că au probleme cu static). Defeats the purpose of the tests să le evaluați pe toate la finalul semestrului. * Social skills: * friendly si sa îi ajutați pe toti pe tot parcursul labului, să nu stați izolați la laptop pe tot parcursul laboratorului și doar la final să le vedeți exercițiile. * dacă vedeți că unii sunt nesiguri pe skillurile lor, se deprimă, se panichează, try to be there for them, să le arătați că they can do it. * nu fiți aroganți cu ei * Sa îi încurajați să folosească documentația claselor de Java, nu copy-paste fără să gândească de pe stackoverflow. * Sa îi incurajați să întrebe pe forum, pe teams sau pe mail pentru ca sa nu să vă bată la cap pe facebook. * Dpdv al organizării, la primul laborator este suficient să le ziceți de regulamentul de pe wiki, pagina de organizare cu echipa și calendarul. Să le spuneți care sunt obiectivele materiei (java dar si lots of oop, design patterns, coding style, no-gui stuff. Sfaturi in plus fata de cele de mai sus pt online: * Fiți cu video on voi asistenții, chiar dacă studenții nu o sa fie. Puneți-va background fake dacă nu doriți să vi se vadă ce e prin camera * Explicațiile * ei au la dispoziție videouri cu explicații însă e indicat să începeți și voi discuții cu ei pe teams, mai mult de tip Q&A axat pe ce nelamuriri au, ce ar dori sa le explicați din lab/exerciții * le puteti axa mai mult pe partea de exerciții, e util chiar sa dați screen pentru a le explica anumite exemple/părți * la primul lab e indicat să începeți prin a le arăta resursele utile de pe wiki, lucruri de oragnizare, nu vă lungiți însă prea mult * Code review * nu întârziați cu el, ei au deadline de 48 de ore, e bine ca și voi să vă uitați pe codul lor până la următorul lab * le dați nota după ce au adresat comentariile, iar dacă nu au timp sau nu vor, le puteți pune nota pentru cât au făcut * nu vă sfiiți să le dați si nit-uri, aka comentarii despre lucruri de code style sau pentru a face codul mai citibil * păstrați un ton neutru în comentarii și prietenos, este foarte ușor de greșit și de părut ironic/agresiv în scris ==== Teme ==== Subechipele temelor au următoarele responsabilităţi: * gândirea ei într-o manieră ce permite testarea automată * redactarea enunţului * elaborarea şi publicarea tester-ului * adăugarea soluției și checker-ului în repository (see also https://oop-pub.slack.com/messages/C5Z58FTEE/details/) * crearea unui forum specific temei respective şi trimiterea unui anunţ referitor la publicarea temei ̧si a eventualelor recomandări * răspunderea la întrebarile de pe forum din partea studenţilor * corectarea temei în maxim o lună de la expirarea termenului (două săptămâni în cazul primei teme si până la începerea sesiunii pentru a ultima temă) Pentru fiecare temă, tester-ul se publică o dată cu publicarea enunţului (chiar dacă nu este încă pus pe vmcheker). :!: Verificarea temelor de copiere se va face atunci cand se corectează temele, de către responsabilii fiecărei teme. Instrucțiuni pt configurarea temei pe vmchecker: * https://github.com/rosedu/vmchecker#add-a-new-instance - adăugare de nouă instanță pentru anul universitar - pentru prima temă * https://groups.google.com/d/msg/poo_asist/bDv5vEXUoOc/CpMySIJM_WYJ * https://groups.google.com/d/msg/poo_asist/9TepsUL2lPU/jk_iopAbJcoJ === Corectare teme === <note tip>Aici aveți un ghid detaliat pentru corectarea temelor.</note> * vă conectați la poo@elf.cs.pub.ro * structura de foldere care vă interesează: vmchecker-storer/repo/tema{N}/studentX/current * in folderul current * grade.vmr - aici treceţi toate observaţiile legate de tema şi vă semnaţi * run-stdout.vmr - output-ul checker-ului * Recomandare: pentru fiecare temă, scrieți feedbackul într-un alt fișier, iar după ce corectați toate temele mutați conținutul în fișierele grade.vmr corespunzătoare (pot apărea schimbări de barem pe măsura ce corectați). Scriptul de copiere îl găsiți în repository în directorul moss/. * Recomandare: pentru a putea naviga ușor prin directoarele și prin fisierele din mașina virtuală de pe VMChecker, puteți să vă conectați prin SSH la mașina virtuală folosind Visual Studio Code, prin opțiunea de Remote SSH, astfel puteți să vă uitați ușor pe fișierele din temă când o corectați și să treceți observațiile legate de temă. ==== Catalog ==== * Se utilizează un spreadsheet public, disponibil în drive * Fiecare asistent trece notele semigrupelor sale la sfârşitul fiecărei săptămâni ==== Teste săptămânale ==== * Se dau din materia laboratorului precedent * Scopul lor este de a verifica înțegerea noțiunilor din labul precedent, nu să le dăm întrebări capcană care să le testeze inteligența sau timpul de răspuns.**
  • 1-2 întrebari cu răspuns liber, durata de maxim 10 minute.
  • Avem un channel pe slack pentru aceste teste și aici puteți să discutați întrebări sau să cereți feedback pentru o întrebare pe care doriți să o dați.
  • Avem deja un pool de întrebări din alți ani, iar dacă propuneți altele, vă rugăm să le treceți aici. Dacă dați o întrebare existentă completați aici laboratorul la care ați dat-o (e.g. Lu 10-12).
  • Este util pentru ei să discutați soluția întrebărilor date imediat după test, înainte de a începe discuția laboratorului curent. Nu este timp să corectați și să discutați ce a făcut fiecare individual.
  • Pentru a eficientiza, puteti sa veniti cu intrebarea printata, mai ales daca contine snippet de cod, si ei scriu si direct pe acea foaie.

Test final

  • Dacă vă vin idei de întrebări pentru testul grilă, vă încurajăm să le treceți în documentul din drive
  • Este necesară prezenţa a cel puţin 3 asistenţi pentru supraveghere şi corectare
  • Subechipa acestui test se va ocupa cu alegerea întrebărilor și generarea testului

Tutoring

  • Echipa separata fata de cea de laborator
  • Pentru mai multe detalii vezi in regulament

Convenţii de redactare

poo-ca-cd/intern/regulament.1602433927.txt.gz · Last modified: 2020/10/11 19:32 by adriana.draghici
CC Attribution-Share Alike 3.0 Unported
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0