Sąvokos
Savaičių numeriai ir kodėl kalendoriaus yra netinkami
Kiekviena institucija numeruoja savo dėstymo savaites, beveik niekas to nedaro taip, kaip kalendorius, ir tame tarpelyje slypi stebėtinai daug painiavos.
Du skirtingi skaičiai su tuo pačiu pavadinimu
Paklauskite kalendoriaus, kokia savaitė, ir gausite ISO savaitės numerį: 1 savaitė yra savaitė, kurioje yra pirmas sausio ketvirtadienis, o šiaurės pusrutulio akademinių metų pradžioje esate maždaug nuo 36 iki 40 savaitėje.
Paklauskite to paties tvarkaraščių skyriaus ir gausite visiškai kitą skaičių. 1 savaitė yra pirma metų dėstymo savaitė, kur tik ji pagal kalendorių pakliūtų, ir viskas skaičiuojama nuo jos. Tai skaičius, atspausdintas tvarkaraštyje, skaičius auditorijų rezervavimo formoje ir skaičius, kurį naudoja du kolegos, susitardami susitikti 9 savaitę.
Šie du niekada nesutampa, nebent institucijos dėstymo metai atsitiktinai prasideda pirmą sausio savaitę, t. y. niekada. O kadangi abu vadinami savaitės numeriu, programinė įranga, tyliai pateikianti netinkamą, pateikia kažką, kas atrodo visiškai tikėtina.
Kaip atrodo, kai nutinka bloga
Tai neatrodo kaip klaida. Tai atrodo kaip puslapis su skaičiumi viršuje, ir skaičius klaidingas kiekvienoje institucijoje kitu dydžiu — nes kiekviena savo metus pradeda kitą dieną.
Todėl tai brangu. Strigtis pranešama per valandą. Antraštė 36 savaitė, kai visi pastate sako 2 savaitė, pranešama po savaičių, kažkieno, kuris manė, kad nesuprato sistemos, o ne kad sistema nesuprato jo — o tuo tarpu žmonės ėjo į auditorijas pagal tai.
Taisyklė, to išvengti, trumpa: savaitės numeris yra skaitomas, o niekada neskaičiuojamas. Institucija nusprendžia, kur yra 1 savaitė; programinės įrangos darbas yra pranešti, ką institucija nusprendė, o ne išvesti savo skaičių iš datos.
1 savaitė ne visada yra pirmoji egzistuojanti savaitė
Institucijoms įprastai reikia datų prieš jų dėstymo metus: įvadinės dviejų savaičių, perlaikymų laikotarpio, vasaros mokyklos, priklausančios ką tik pasibaigusiems metams. Užuot perskaičiavus viską — o tai tyliai pakeistų kiekvieno tvarkaraščio, kiekvienos rezervacijos ir kiekvieno kada nors išsiųsto pranešimo apie 9 savaitę prasmę — protinga yra pratęsti kalendorių atgal, į nulį ir neigiamus skaičius.
Pirmą kartą tai atrodo keistai, o antrą – visiškai teisinga: 1 savaitė toliau reiškia tai, ką visada reiškė, o dvi savaitės prieš ją yra −1 ir −2 savaitė. Turime institucijų, kurių savaičių lentelė eina toli į neigiamą pusę ir toli už dėstymo metų pabaigos, ir viskas tarp jų nurodo tikrą datą.
Bet kas programiškai skaito tvarkaraštį, turėtų to tikėtis. Savaitės numeris yra sveikasis skaičius su ženklu, o ne skaitiklis, prasidedantis nuo vieneto.
O kai kurios institucijos numerių išvis nenaudoja
Oksfordas ir Kembridžas savaites įvardija pagal semestrą, o ne skaičiuoja per metus: data yra Michaelmas ketvirtoje savaitėje, o skaičius reikštų nieko niekam patalpoje. Kitos institucijos dviejų savaičių laikotarpį pažymi Kartojimas, Įvadas ar Vertinimo laikotarpis ir tikisi, kad tvarkaraštis tai pasakys.
Taigi dėstymo savaitė turi du dalykus, o ne vieną: skaičių, kuriuo programinė įranga ją adresuoja, ir pačios institucijos jai suteiktą pavadinimą, kurio skaitytojas iš tikrųjų nori puslapio viršuje. Kai pavadinimas yra, jis turėtų būti spausdinamas vietoje skaičiaus ir pilnai — kieno nors semestro konvencijos trumpinimas, kad sutaupytų aštuonis pikselius, yra pagalba, kurios niekas neprašė.
Kai pavadinimo nėra, o daugumoje institucijų jo nėra, skaičius yra pavadinimas ir tai visiškai gerai.
Keturi dalykai, kuriuos verta patikrinti bet kurioje tvarkaraščių sistemoje
Nė vienas nėra egzotiškas. Visi kur nors tyliai klaidingi.
| Klausimas | Kaip atrodo geras atsakymas |
|---|---|
| Kur prasideda 1 savaitė? | Jūsų institucijos nustatyta data, saugoma vieną kartą, naudojama visur. Ne išvedama iš kalendoriaus ir ne konfigūruojama kiekvienam ekranui. |
| Ar kalendorius gali eiti prieš 1 savaitę? | Taip, į nulį ir neigiamus skaičius, nieko jau esančio nepernumeruojant. |
| Ar savaitė gali turėti pavadinimą? | Taip, ir pavadinimas spausdinamas vietoje skaičiaus, pilnai. |
| Iš kur studentų programėlė gauna skaičių? | Iš tvarkaraščio, tame pačiame atsakyme kaip ir paskaitos. Klientas, kuris skaičiuoja savo, klys, ir kiekvienoje institucijoje klys kitaip. |
Kodėl tai ir integracijos klausimas
Portalas, programėlė ar informacinis ekranas, rodantis savaitės antraštę, turi ją iš kažkur gauti, ir vienintelis šaltinis, galintis būti teisingas, yra pats tvarkaraštis. Wise Timetable tvarkaraščio atsakyme pateikiami apimamo intervalo savaičių numeriai ir pavadinimai, todėl klientui niekada nebereikia jų skaičiuoti — o GET /v2/weeks tą patį klausimą atsako atskirai ekranui, kuriam reikia pažymėti visą semestrą iš karto.
REST API žinyne abu aprašyti, įskaitant neigiamą atvejį, ir jis skelbiamas pilnai ir be apribojimų, kad kūrėjas galėtų patikrinti atsakymo formą, kol niekas dar nieko nepasirašė.
Norite pamatyti, kaip tai veikia?
Užsisakykite 45 minučių trukmės internetinę prezentaciją, ir mes viską peržiūrėsime remdamiesi Jūsų institucijos tvarkaraščių sudarymo uždaviniu.