Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS »
Discussion: OpenMRS Talk »
Real-Time: IRC Chat

Projects

Skip to end of metadata
Go to start of metadata

Primary mentor

Shreyans Sheth

Backup mentor

Pascal Brandt

Assigned to

TBD

Interested PeoplePascal Brandt Shreyans Sheth

 

Abstract

Most developers these days prefer to be writing against a RESTful API. Just like GitHub, Amazon, and many others, OpenMRS has a powerful RESTful API; however, an API is only as useful as its documentation. During GSoC 2015, the REST Documentation Generator project used Swagger to generate REST API documentation within the REST web services module. You can see this documentation at demo.openmrs.org by logging in as admin (password is Admin123) and navigating to System Administration > Advanced Administration > REST Web Services > API Documentation.

While the Swagger-based documentation has been helpful, there are several opportunities to improve the documentation. The goal of this project is to improve the living documentation of the OpenMRS REST API through improvements in how Swagger is used and how developers can contribute to the documentation.

Project Champions

  • Burke Mamlin

Objectives

  • Improve documentation
    • RESTWS-560 - Create API Overview Docs Code Review (Initial)
  • Optimization
    • RESTWS-568 - Optimize Swagger Spec Creation Closed
  • Support for data types
    • RESTWS-562 - Improve Resource Definition Documentation Code Review (Post-Commit)
  • Add search functionality
  • Bug fixes
    • RESTWS-600 - Swagger documentation not correct for Encounter Search Closed
    • RESTWS-382 - Access-Control-Allow-Origin in response headers Ready for Work

Extra Credit

  • TBD

Resources