Last modified: Fri Aug 16 2019 11:27:04 GMT+0000 (Coordinated Universal Time)

How to propose a change?

Are you missing something in the Winding Tree ecosystem? The data model does not cover everything you need? In this article, you will learn, how to reach to us and propose a change.

Step by step

All of our code is open sourced and publicly available on GitHub. Both data model and API specifications are in OpenAPI Specification format.

We are definitely open to all alterations, suggestions and improvements and the right place for them is on GitHub where everybody can join the discussion.

Locating the proper place

The work on GitHub is separated in repositories. And each repository contains a specific part of the ecosystem. The first step in proposing a change is in locating the appropriate repository.

You will need a GitHub account for this - but you don't need any paid plan.

Filing an issue

Every repository on GitHub has a section called Issues, where everybody (including you!) can raise their voice and propose a change. So if you feel that something is missing or can be improved, open an Issue in the respective repository and somebody will respond eventually.

Issues are also a good place for alterations that are not clear or require some more research or deeper discussion, for example.

Hit the New Issue button to create an issue Hit the New Issue button to create an issue

Sending a change

If you are pretty sure what you would like to change and are willing to go hands deep, there's always an option of opening up a Pull Request.

The easier way is to use GitHub directly and create a Pull Request online.

  1. Navigate to the file where you want to make a change. For example the data model for Hotel part of the platform is here.
  2. Follow this excellent guide.

If you are more experienced with coding or GitHub, you can follow the usual routine of Fork-Update-Send PR. If you are not familiar with GitHub per se, there are many helpful tutorials around.