GSoC 2025: Enhancing OpenAPI Documentation Generation - Weekly Updates & Talk

Hi everyone! :waving_hand:

I’m Marvin Sukumar, an undergraduate student studying computer science in Mumbai, India. I’m thrilled to be selected as a Google Summer of Code 2025 contributor with OpenMRS! I thank my mentors @chibongho1 and @mherman22 for consistently guiding me throughout.

:memo:Project Overview

My project is focused on replacing the current OpenMRS Standalone REST documentation generation process with a modern, automated system that generates OpenAPI 3.0 specifications at build-time.

The idea is to reduce the manual, error-prone approach currently used, and instead build a custom Maven plugin that extracts and constructs API specs using:

  • Annotation processing
  • Static code analysis
  • Javadoc integration
  • And OpenMRS-specific REST handler support

Ultimately, the goal is to provide an accurate, complete, and maintainable OpenAPI 3.0 specification

:spiral_calendar: Updates and Progress

I’ll use this thread to:

  • Post weekly updates
  • Share blockers and discussions
  • Get feedback from mentors and the community
  • Keep the documentation trail open and transparent

Feel free to ask questions, give suggestions, or help me debug tricky areas! I’d love to collaborate closely with everyone here. :raising_hands:

I plan on making weekly blog posts, preferably on Notion but any inputs or suggestions would be appreciated.

Resources & Links

Notion Doc: Your connected workspace for wiki, docs & projects | Notion

Proposal: Marvin_GSOC_Proposal.pdf - Google Drive

Project Description: Enhancing OpenAPI Documentation Generation - Projects - OpenMRS Wiki

cc: @ibacher @dkayiwa @grace @jayasanka

4 Likes