Welcome to the git repository for www.api-first.com!
We've established API-first.com to evolve over time as teams experiment with our suggestions and share insights of their own. You can contribute your thoughts, edits, comments, stories, and visions here. Feel free to challenge what we've written and share your learnings!
API-first will be stronger if we can learn from each other. We invite you to contribue your experineces in the form of a blog post. Please fork this repo and submit your new post in the form of a pull request.
Aside from content, there are 2 parts of the site that need the most help: the Community page and Illustrations. If you've given a relevant talk or written a related blog post, please submit to our community page. We also need help turning our ugly process flows into beautiful illustrations. If that is something you can help with, please let us know!
To contribute, please fork the site and send us a pull request with your changes. GitHub has some excellent free tools to help you. I cannot guarantee that all content will make it into the site, but if enough folks think your contribution adds value, we will be sure to include it.
Rather than have the community's knowledge burred in comments, we would rather let you contribute directly to the site. This gives you first-class access to share what you know with the world. Please contribute!
api-first.com is a static site hosted by GitHub pages. We use Jekyll to build the site and test it locally. Here's a quick guide:
- fork the project
- install Ruby (comes with OSX)
- git clone this project
- install bundler
- install the gems this project needs with
bundle install - run jekyll
jekyll serve --watchwhich will run this site locally on port 4000. - send your change in a pull request, and once they are merged, your changes will be up on the site!