search

lunduniversity / introprog

Teaching material for "Introduction to Programming using Scala" at Lund University, LTH. http://cs.lth.se/pgk/
142 stars 177 forks source link

Improve readability in "verktyg" page #654

Closed oliverlevay closed 4 months ago

oliverlevay commented 2 years ago

https://cs.lth.se/pgk/verktyg/

Right now the instructions are unclear and students with a windows machine for example has to filter out a lot of information about mac / linux and figure out what to keep and not to keep. Suggestion is to make the instructions more divided, and I would personally like a numbered list.

  1. Install Java
  2. Install Scala
  3. Install vscode
  4. blablabla
bjornregnell commented 1 year ago

Update live now at https://cs.lth.se/pgk/verktyg/ What Do You Think @oliverlevay

theolundqvist commented 1 year ago

Kan man kanske lägga en toc under rubriken verktyg i navigationsmenyn på vänster så som det ligger en om man klickar på "schema"

image

Förslagsvis med samma rubriker som redan ligger i texten. Windows linux mac editor kojo

theolundqvist commented 1 year ago

Hörde med studenterna i salen och de tyckte att det var lite klurigt att installera allt man behövde men att det gick bra i och med guiden på kurshemsidan eller att det gick bra i och med hjälpen man fick. (Installationskvällar/handledare osv)

bjornregnell commented 1 year ago

Bra idé! Vi tar det inför nästa år - då har även kanske det klarnat hur övergången från typo3 till drupal ska gå till och om våra drupal-sysadmin kommer tillåta att jag med javascript suger in html-kod på sidorna. Om inte så kommer jag flytta vissa sidor som rör på sig varje år till readme.md-liknande filer på github eftersom det är för svårt att uppdatera med musarmsriskerande gui på ännu ett ställe...

bjornregnell commented 4 months ago

Att ha sidomenyer får inte i typo3 med javascript-hacket och oklart när drupal påtvingas oss. Jag stänger denna nu eftersom läsbarheten av verktygssidan är klar med en rubrik per os etc.