RAML.org on Github and Jekyll


Today, we announced the successful migration of our website, https://raml.org, to Github and Jekyll. It is our first step towards working closer with our community on fixing issues, adding more content, and making the site more user friendly.

The migration comes with a few advantages for our maintainers, but also for you!

Raising issues

Have you found a spelling mistake, something incomplete, or not well defined? Now you can fork the website and send us a pull request to fix the issue. This gives you a chance to actively contribute and help us fix issues faster.

Adding new blog posts

Do you want to contribute a compelling blog post? Again, simply fork the repo and send us a pull request. We will review your content to see if it appropriate. An example of the type of content we are looking would be a story on how you used RAML to create a new tooling.

Adding new projects

Tooling is an vital part of any community, and we want to make it as easy as possible for you to find examples. With the web migration, we are including a new project section and new ways you can add your project.

There are two ways:

  • Add your project to our list on the web site by forking the repo and adding the necessary information to a simple YAML file. Then send us a pull request and we will review before merging it.
  • If you have your project on Github, add topics to your repository. We have predefined topics that we link on the project website. Clicking on these will redirect users to Github, with your project included inside a search result.

For more information, please have a look here.

To start now send us feedback by going to our website’s repository. Contact us if you find a mistake or have ideas on content!

Stay tuned for more changes coming up in the next few months!