• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar
  • Skip to footer
HAMK Unlimited

HAMK Unlimited

Julkaisuja Hämeen ammattikorkeakoulusta

  • Lehdet
        • Professional
        • Journal
        • Scientific
  • Alat
        • Ammatillinen osaaminen ja opetus
        • Biotalous ja luonnonvara-ala
        • Hyvinvointi ja sote-ala
        • Kulttuuri ja muotoilu
        • Teknologia ja liikenne
        • Yrittäjyys ja liiketoiminta
        • Muut
  • Kokoelmat
        • Avoin Häme
        • CleanExport
        • Digitalisaatio ja muutos / Digitalization and Change
        • DigiTrail
        • Employers’ perspectives on ePortfolios
        • Empowering ePortfolio Process
        • Higher education perspectives on ePortfolios
        • Innovaatiojohtaminen
        • Liikenne 4.0
        • Luomussa vara parempi
        • PoliRural – Hämeen maaseutua kehitetään tulevaisuutta ennakoimalla yhdessä
        • Problem-based learning & agropreneurship in Africa
        • Maahanmuuttajien urareitit
        • Nuoret huippumyyjät
        • Office 365 -intran käyttöönotto HAMKissa
        • Oppimisen digiagentit II
        • Students’ perspectives on ePortfolios
        • TAIKOJA
        • Uudistuva hevostalous
        • Universal Design for Learning (UDL)
        • KIITO – Kiertotalousosaamisella uudistuvaa liiketoimintaa
  • In English
        • Articles in English
        • About HAMK Unlimited
        • Instructions for writers
        • Instructions for reviewers
        • Contact editorial staff
  • Ohjeet
        • Kirjoittajan ohjeet
        • Arvioijan ohjeet
        • Info
/ HAMK Unlimited Professional / Ammatillinen osaaminen ja opetus /

Enhancing Open Learning Platforms with MkDocs at HAMK

Image © Aozora / Adobe Stock

Tero Keso & Quang Luong

17.04.2025
Kuuntele - Listen

In higher education, teaching is increasingly becoming accessible 24/7. This poses challenges for classical educational environments. One way to solve this problem is to move teaching materials to open platforms where students can access the material at any time. This article discusses one such platform, Github Pages, which allows you to publish teaching materials easily and for free so that they are easily accessible to hundreds to thousands of students. Github Pages has already become one of many platforms for scientific publications due to its free cost and scalability.

Identifying the Challenges

The Business Information Technology and Computer Applications (BIT/CA) programmes at Häme University of Applied Sciences (HAMK) have traditionally relied on Moodle to host course materials. While Moodle is a powerful open-source virtual learning environment that supports online courses, content sharing, and student interaction, it has limitations when it comes to handling large volumes of documentation and code.

Despite its many add-ons and plugins, Moodle lacks flexibility when teaching coding, virtualization, and operating systems. Expanding its capabilities requires ongoing maintenance and is limited to HAMK’s students and staff. Seeking a more open and flexible solution, teachers initially transferred course materials to GitHub gists, repositories, and pages, linking them to Moodle. While this method has improved accessibility, it has also introduced usability and integration challenges, leading to confusion among students.

Recognizing these challenges, the BIT/CA programmes initiated research into alternative platforms and selected the second author of this article, Quang Luong, to contribute to the project by testing solutions and designing a more user-friendly template.

Implementing MkDocs with the Material Theme

To enhance the documentation experience, the project focused on implementing MkDocs with the Material theme. MkDocs is a static site generator which is simple, fast, and elegant for creating technical documentation. This approach introduced modern features essential for effective learning, including:

  • dark/light mode switching
  • built-in code highlighting
  • line numbering
  • a copy button for code snippets.

These features significantly improved usability for students and educators alike (Figures 1 & 2). As education increasingly embraces open-access resources, MkDocs offers a structured, interactive, and visually appealing platform for hosting teaching materials.

Figure 1. Screenshot of the BYOD (Bring Your Own Device) page.
Figure 2. Screenshot of the same BYOD page, on a mobile device.

Project Roles and Contributions

Both authors played complementary roles in the project. Tero Keso initiated and supervised the project, ensuring alignment with HAMK’s broader goals of accessibility and open learning. Quang Luong focused on customizing Material for MkDocs to meet the specific needs of the BIT/CA programmes. With additional support from senior lecturer Deepak Kc, the team developed:

  • A working MkDocs template
  • A comprehensive documentation guide
  • An updated BYOD (Bring Your Own Device) page reflecting HAMK’s branding

This setup introduced key functionalities such as enhanced search, interactive code examples, and multimedia support, making it especially beneficial for students in Business Information Technology and Computer Applications.

Integrating MkDocs with Moodle

The transition to MkDocs does not replace Moodle; rather, it complements it. Moodle remains the primary tool for assignments and discussions, while MkDocs-based materials are seamlessly integrated within it. This approach ensures that students have access to structured, up-to-date resources without disrupting the existing learning management system.

By bridging these two platforms, the project supports HAMK’s mission to provide open and accessible education. It fosters a collaborative learning environment that benefits not only HAMK students and degree programme but also the wider academic community.

Conclusion

This project extends beyond technical enhancements—it represents a meaningful step toward improving digital education at HAMK. By adopting MkDocs, we have created a more flexible and engaging platform that enhances both teaching and learning. Through this initiative, we support educators, empower students, and contribute to a future-ready approach to open learning.


Interested in this topic? Take a look at the related materials:

  • The MkDocs template for HAMK BIT/CA material
  • The documentation guide
  • The BIT/CA BYOD page

Authors

Tero Keso, Senior Lecturer at Häme University of Applied Sciences (HAMK)

Quang Luong, student, BSc degree in Computer Applications, Häme University of Applied Sciences (HAMK)

LISÄÄ AIHEEN YMPÄRILTÄ / RELATED POSTS

The Use of ePortfolios in Higher Education: A Case Study Nainen seisoo vr-lasit päässä, taustalla taivasta.​The hunt for perfect virtual project room Pedagogical Goals and Practical Implementations within the Finnish-Brazilian Gira Mundo Finlândia Pilot Programme Flipped ePortfolio as a tool to increase student motivation
PREVIOUS POST Kohtaamisia urapolulla – sosionomiopiskelijoiden uraohjauksen pilotti
NEXT POST Tunteet mukana lääkelaskennan oppimisessa

Primary Sidebar

PYSYVÄ OSOITE / URN

https://urn.fi/URN:NBN:fi-fe2025041527550

LISENSSI / LICENCE

This material is CC licensed Attribution-ShareAlike 4.0 International.

Avainsanat / Keywords

accessibility Business Information Technology code Computer Applications Mkdocs materials moodle open sources teaching materials

VIITTAUSOHJE / CITE THIS ITEM

Keso, T. & Luong, Q. (2025). Enhancing Open Learning Platforms with MkDocs at HAMK. HAMK Unlimited Professional, 17.4.2025. https://urn.fi/URN:NBN:fi-fe2025041527550

Footer

HAMK UNLIMITED

HAMK Unlimited on Hämeen ammattikorkeakoulun open access
-julkaisuportaali. Julkaisuista vastaa HAMKin toimituskunta.
julkaisut@hamk.fi

TIETOA SIVUSTOSTA

Alasottoilmoitus
Käyttöehdot
Saavutettavuusseloste

Häme University of Applied Sciences

Copyright © 2025 · Genesis Sample on Genesis Framework · WordPress · Log in

Sivustollamme hyödynnetään evästeitä, jotta voimme seurata sivuston käyttöä ja kehittää palveluamme. HyväksyKieltäydyLISÄTIETOJA