New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Unify courses and raw materials #154

Open
Sanqui opened this Issue Jun 21, 2017 · 5 comments

Comments

Projects
None yet
3 participants
@Sanqui
Member

Sanqui commented Jun 21, 2017

Currently, we have two ways to access course materials. The link "Materiály", leading to /courses/, and the link "Kurzy", leading to /runs/. The overlap in their contents is significant and bound to result in confusion. The individual pages for lessons are also duplicated, for instance:

http://naucse.python.cz/lessons/beginners/cmdline/
http://naucse.python.cz/2017/pyladies-praha-jaro/beginners/cmdline/

These pages are templated differently, with the latter having an (arguably) nicer style with a custom font. It also gives a way to go to the next lesson.

These two ways to access lessons should be unified. My approach would be to turn the raw, online-first materials into special (canonical) runs.

@encukou

This comment has been minimized.

Member

encukou commented Jun 21, 2017

This is just a presentation issue; they're already nearly the same in the model ("runs" have extra metadata like dates though).
On the web, I'd like to keep them separate: they serve very different audiences with different needs.

@Sanqui

This comment has been minimized.

Member

Sanqui commented Jun 21, 2017

The model is nearly the same, yes, so I propose unifying that (less code doing the same thing, and only one definition to maintain).
I would also like to keep them separate on the web. In fact, I'd like to make the difference more clear. I think calling the raw materials something like "kurz pro samouky" would help.

@Sanqui

This comment has been minimized.

Member

Sanqui commented Jun 21, 2017

So my proposal is to scrap materials and turn them into runs, while keeping them separate in presentation.

@Krejdom, are you working on something like this? Do you have any thoughts, or can I go ahead?

@Krejdom

This comment has been minimized.

Contributor

Krejdom commented Jun 21, 2017

@Sanqui You can go ahead. :)

@Sanqui

This comment has been minimized.

Member

Sanqui commented Jun 21, 2017

Nějaké komentáře, ať se to nezapomene.

  • Jednotné názvosloví: "kurzy" == "courses", žádné "runs"
  • Kurzy "naživo" a kurzy "pro samouky" (kanonický)
  • Kurz "pro samouky" je označený jako kanonický, lekce z kurzů naživo odkazují na příslušnou lekci v kanonickém kurzu.
  • Oba typy kurzů vypadají stejně a mají stejnou funkcionalitu
  • Každý typ kurzů má zvláštní stránku se seznamem dostupných kurzů. Tyto dvě stránky na sebe vzájemně odkazují: "Pokud hledáte kurzy pro samouky, ..."
  • Stránka jedné lesson pro začátek zůstává jak je, ale už na ni nic nebude odkazovat. Bude mít canonical na příslušnou stránku v kanonickém kurzu. V budoucnu z ní bude metastránka o lesson s např. seznamem v jakých kurzech se nachází či feedbackem. Per @encukou
  • Navazující feature: V rámci kurzu může být i lekce, která není explicitně součást toho kurzu. např. odkaz na lekci o základech terminálu v pokročilém kuzu, která potom bude mít pouze odkaz zpět. Per @encukou

@Sanqui Sanqui self-assigned this Jun 21, 2017

@Sanqui Sanqui added code enhancement and removed discussion labels Jun 21, 2017

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment