Contributing

Thank you very much for your time contributing to the Goyave framework!

Workflow

• New features and changes are first discussed in Github discussions.
  • This is where we settle on a design and discuss about it.
  • If we decide that we want work to be done on the subject, then an issue will be created. This issue will reference the original discussion. Issues can then be used for tracking progress or show to potential contributors how they can help.
  • If a pull request is opened, it should reference both the issue and the discussion it is associated with. Further comments will now take place on the pull request instead of the original discussion.
• Assistance requests and support also belong to the discussions section.
• Bugs, typos, improperly working features or code are reported in the issues section.
• When creating an issue, please use one of the available issue templates.
• If there is no template that fits your needs, consider opening a discussion instead.
• For pull requests, please use the pull request template and select the master branch as target branch.
  • Ensure that the submitted code works, is documented, respects the Golang coding style and is covered by tests.
  • The project is linted using golangci-lint and the configuration defined in .golangci.yml.
  • The documentation is living in another repository. If you are willing to add to the documentation, please open a pull request there.
  • Please use the latest stable version of the Go programming language. The latest two Go version are tested in the Github Actions workflow.
  • Tests can be run locally without any special action or setup needed.

If you would like to contribute but you are not sure on what you could work, the issues section is a good place to start. Check the issues with the "contributions welcome" tag. Of course, other ideas are also very much welcome!

Design philosophy

The goal of the project is to provide an opinionated framework for REST API building. Using it must be simple, while staying flexible and hackable. We don't want to gate too many things so developers have the freedom to build whatever they want, even edge cases. However, the goal is to make the most common cases a breeze, so they can focus on what their app really does: the business logic. For example, it is extremely common to have some sort of permissions on resources in REST APIs, so instead of forcing developers to spend time working on this, which can be complicated, Goyave would provide a comprehensive set of tools to achieve this. On top of this, Goyave strives to reach a level of quality that exceeds the expectations and that would allow companies and independents to build large scale applications with confidence.