Problem/Motivation

It is at the moment difficult to access all the open source material from the project.
We need a way to:

  • document the project
  • give access to material
  • promote the vision

Proposed resolution

Use Astro and Gitlab CI to create engaging pages that make it easy for the users to find the documentation and the material they need to foster the next generation of Drupal developers.

Remaining tasks

  1. create Pages with Astro and Gitlab CI
  2. architect the content of the pages
  3. populate the pages
  4. use Gitlab CI to compile the material from the sources

you can view the pages here: https://project.pages.drupalcode.org/open_university/

Comments

guzmanb created an issue.

guzmanb’s picture

guzmanb commented

I created a boilerplate for the page on gitlab. you can find the result here https://project.pages.drupalcode.org/open_university/

I made the following decisions:

Astro (Stralight template)

  • the content can be created with simple markdown pages
  • it can be fully customized if needed
  • pleasing aesthetics

Project structure (docs/user)

I put the pages in the docs/user folder instead of the root.
the documentation is intended for the "end user". There will be other documents and materials stored in the project folder (with their own documentation). e.g. the course syllabus.

Do these decision make sense ?

guzmanb’s picture

guzmanb commented

The CI jobs still need fixing. (Spelling, Linting, ... are missing)

guzmanb’s picture

guzmanb commented

Give credit where credit is due, it is heavily inspired by the canvas docs https://project.pages.drupalcode.org/canvas/