Oppimateriaalien vanhenemisen estäminen

Lyhyesti yliopistojen tilanteesta (omakohtainen kokemus)

Aluksi kannattaa todeta, että esitettävä aineisto on subjektiivista, niin sanotusti "näkymää sisältä", mutta tuntuu siltä, ​​että tieto on relevanttia monille valtiollisille yliopistoille post-Neuvostoliitossa.

IT-asiantuntijoiden kysynnän vuoksi monet oppilaitokset ovat avanneet sopivia koulutusalueita. Lisäksi myös muiden kuin IT-erikoisuuksien opiskelijat ovat saaneet monia IT-aiheisia aineita, usein Python, R, kun taas vähemmän onnellisten opiskelijoiden on hallittava "pölyisiä" akateemisia kieliä, kuten Pascal.

Jos katsot syvemmälle, kaikki ei ole niin yksinkertaista. Kaikki opettajat eivät pysy "trendeissä". Itse jouduin opiskellessani "ohjelmointi"-erikoisuutta, että joillakin opettajilla ei ole ajan tasalla olevia luentomuistiinpanoja. Tarkemmin sanottuna opettaja lähetti rehtorille kuvan jonkun oppilaan käsinkirjoittamista muistiinpanoista muistitikulle. Olen täysin vaiti tällaisten materiaalien, kuten WEB-ohjelmoinnin käsikirjojen (2010), merkityksestä. Jää myös arvailla mitä teknillisissä kouluissa ja pahin pahimmasta koulutusinstituutiot.

Yhteenvetona:

  • He tulostavat paljon epäolennaista tietoa pyrkiessään kvantitatiivisiin akateemisiin indikaattoreihin;
  • Uuden materiaalin julkaisu on järjestämätöntä;
  • "Trendikkäät" ja ajankohtaiset yksityiskohdat jäävät usein huomaamatta yksinkertaisen tietämättömyyden vuoksi;
  • Palautteen antaminen kirjoittajalle on vaikeaa;
  • Päivitettyjä painoksia julkaistaan ​​harvoin ja epäsäännöllisesti.

"Jos et ole samaa mieltä, kritisoi, jos kritisoit, ehdota..."

Ensimmäinen asia, joka tulee mieleen, on moottoripohjaisten järjestelmien käyttöönotto Media wiki. Kyllä, kyllä, kaikki ovat kuulleet Wikipediasta, mutta se on luonteeltaan tietosanakirjallinen. Olemme enemmän kiinnostuneita oppimateriaalista. Wikikirjat sopii meille paremmin. Haittoja ovat mm.

  • kaikkien materiaalien pakollinen avoimuus (lainaus: "Täällä wikiympäristössä opetuskirjallisuutta kirjoitetaan yhdessä, jaetaan vapaasti ja kaikkien saatavilla.")
  • jonkin verran riippuvuutta sivuston säännöistä, käyttäjien sisäisestä hierarkiasta
    Julkisessa käytössä on monia wikikoneita, mutta mielestäni ei ole tarvetta edes alkaa puhua mahdollisuudesta ottaa käyttöön wikijärjestelmä yliopiston mittakaavassa. Kokemuksesta sanon, että: a) tällaiset itseisännöidyt ratkaisut kärsivät vikasietoisuudesta; b) voit unohtaa järjestelmäpäivitykset (erittäin harvoja poikkeuksia lukuun ottamatta).

Mietin pitkään turhaan, miten tilannetta voisi parantaa. Ja sitten eräänä päivänä tuttava sanoi, että hän oli kauan sitten painanut luonnoksen kirjasta A4:lle, mutta kadonnut sähköisen version. Olin kiinnostunut kuinka muuntaa kaikki sähköiseen muotoon.

Tämä oli oppikirja, jossa oli huomattava määrä kaavoja ja kaavioita, joten suosittuja OCR-työkaluja, mm. Abbyy hieno lukija, vain puoli auttoi. Finereader tuotti pelkkää tekstiä, jota aloimme syöttää tavallisiin tekstitiedostoihin, jakamalla ne lukuihin ja merkitsemällä kaiken ylös MarkDownissa. Ilmeisesti käytetty mennä yhteistyön helpottamiseksi. Käytimme etävarastona BitBucket, syynä oli mahdollisuus luoda yksityisiä tietovarastoja ilmaisella tariffisuunnitelmalla (tämä pätee myös GitLab). Löytyi kaavan lisäyksille Mathpix. Tässä vaiheessa vihdoin käännyimme kohti "MarkDown + LaTeX", koska kaavat muunnettiin LaTeX. Käytimme muuntaaksesi pdf-muotoon Pandoc.

Ajan myötä yksinkertainen tekstieditori ei riittänyt, joten aloin etsiä korvaavaa. Kokeili sitä Typora ja useita muita vastaavia ohjelmia. Tuloksena päädyimme verkkoratkaisuun ja aloitimme sen käytön pinottu, kaikki tarvittava oli siellä synkronoinnista githubin kanssa LaTeX-tukeen ja kommentteihin.

Tarkemmin sanottuna tuloksena kirjoitettiin yksinkertainen käsikirjoitus, jota häpeän ja joka suoritti tehtävän koota ja muuntaa kirjoitettu teksti WEB:ksi. Yksinkertainen HTML-malli riitti tähän.
Tässä ovat komennot WEB:ksi muuntamiseen:

find ./src -mindepth 1 -maxdepth 1 -exec cp -r -t ./dist {} +
find ./dist -iname "*.md" -type f -exec sh -c 'pandoc "
find ./src -mindepth 1 -maxdepth 1 -exec cp -r -t ./dist {} +
find ./dist -iname "*.md" -type f -exec sh -c 'pandoc "${0}" -s --katex -o "${0::-3}.html"  --template ./temp/template.html --toc --toc-depth 2 --highlight-style=kate --mathjax=https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML' {} ;
find ./dist -name "*.md" -type f -exec rm -f {} ;
" -s --katex -o "${0::-3}.html" --template ./temp/template.html --toc --toc-depth 2 --highlight-style=kate --mathjax=https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML' {} ; find ./dist -name "*.md" -type f -exec rm -f {} ;

Se ei tee mitään älykästä, mitä voidaan huomata: se kerää sisällön otsikoita navigoinnin helpottamiseksi ja muuntaa LaTeX:n.

Tällä hetkellä on ajatus automatisoida koonti, kun työnnät toistoja githubissa käyttämällä Continuous Integration -palveluita (Circle CI, Travis CI..)

Mikään ei ole uutta...

Kiinnostuttuani tästä ideasta aloin etsiä, kuinka suosittu se nyt on.
Oli ilmeistä, että tämä idea ei ole uusi ohjelmistodokumentaation kannalta. Olen nähnyt useita esimerkkejä ohjelmoijien opetusmateriaaleista, esimerkiksi: JS-kurssit learning.javascript.ru. Kiinnostuin myös ideasta git-pohjaisesta wikimoottorista nimeltä Gollum

Olen nähnyt melko monia arkistoja, joissa on kokonaan LaTeX:llä kirjoitettuja kirjoja.

johtopäätös

Monet opiskelijat kirjoittavat muistiinpanoja useita kertoja uudelleen, jotka he kirjoittivat monta, monta kertaa aiemmin (en kyseenalaista käsin kirjoittamisen etua), joka kerta kun tiedot katoavat ja päivittyvät hyvin hitaasti, kaikki muistiinpanot eivät, kuten ymmärrämme, ole sähköisessä muodossa. Tämän seurauksena olisi siistiä ladata muistiinpanot githubiin (muuntaa pdf-muotoon, verkkonäkymä) ja tarjota opettajille sama. Tämä houkuttelisi jossain määrin opiskelijoita ja opettajia "elävään" kilpailukykyiseen GitHub-yhteisöön, puhumattakaan absorboidun tiedon määrän lisäämisestä.

Esimerkiksi Jätän linkin kirjan ensimmäiseen lukuun, josta puhuin, tässä hän on ja tässä linkki siihen rap.

Lähde: will.com

Lisää kommentti