ocaml.org icon indicating copy to clipboard operation
ocaml.org copied to clipboard

(Data) Extend the Data Model of Academic Institution to Record Information about Course Materials

Open sabine opened this issue 1 year ago • 6 comments

In the Wireframes for the improved "Teaching and Research" page (formerly "Academic Users"), we list course materials from lectures.

To make this truly useful, we need to improve the data model in academic_institution.ml:

  1. Add a field year : int option to course, so that we can sort the courses by most recent.
  2. Add a field lecture_notes_available: bool option to represent whether lecture notes can be found at the URL pointed to by the field online_resource
  3. Similarly, add a field exercises_available: exercise_availability option where type exercise_availability = Yes | Interactive (where Yes maps to the string "yes", and Interactive maps to the string "interactive") to represent whether there are exercises provided at the URL pointed to by the field online_resource.

To make this data available in the templates, you need to change data.mli and render the new fields to the generated module in academic_institution.ml.

The task here is only to change the data model and maybe update one data entry (as to keep the PR small).

sabine avatar Apr 09 '24 10:04 sabine

Hi Sabine, I'd like to take up this issue. What are the language requirements for this?

0xSaksham avatar Apr 09 '24 11:04 0xSaksham

Hey @0xSaksham, would be happy to have you! This issue is all about making changes to OCaml code.

To confirm that the data is available to the templates, you might want to try and render the data to the the EML template academic_users.eml (this file format is a mix of OCaml and HTML). Implementing the UI will be a separate issue later, when the design is finalized.

sabine avatar Apr 09 '24 11:04 sabine

hi @sabine, I'd like to work on this issue.

maha-sachin avatar Apr 09 '24 15:04 maha-sachin

Hi, I can pick this up if it's still open. Looks like there's no extra decoding logic here for now.

Is there currently a Dream route serving the academic_users.eml template? Just so I can check that the template hydrates correctly with the new course fields.

csaltachin avatar May 12 '24 06:05 csaltachin

Hey @csaltachin! Yes, there's a route at https://ocaml.org/academic-users.

sabine avatar May 17 '24 16:05 sabine

@sabine I would like to work on this issue if it is not worked upon.

vr-varad avatar Jun 28 '24 05:06 vr-varad