Interested in contributing to Jekyll Admin? We’d love your help. Jekyll Admin is an open source project, built one contribution at a time by users like you.
Where to get help or report a problem
Ways to contribute
Add Jekyll Admin to an existing site. Does it work? Does it do what you'd expect? Anything else you'd like to see? If you have any suggestions, open an issue
Comment on some of the project’s open issues. Have you experienced the same problem? Know a work around? Do you have a suggestion for how the feature could be better?
Read through the documentation, and click the “improve this page” button, any time you see something confusing, or have a suggestion for something that could be improved.
Find an open issue (especially those labeled
help-wanted), and submit a proposed fix. If it’s your first pull request, we promise we won’t bite, and are glad to answer any questions.
Help evaluate open pull requests, by testing the changes locally and reviewing what’s proposed.
Submitting a pull request
Pull requests generally
The smaller the proposed change, the better. If you'd like to propose two unrelated changes, submit two pull requests.
The more information, the better. Make judicious use of the pull request body. Describe what changes were made, why you made them, and what impact they will have for users.
Pull request are easy and fun. If this is your first pull request, it may help to understand GitHub Flow.
If you're submitting a code contribution, be sure to read the code contributions section below.
Submitting a pull request via github.com
Many small changes can be made entirely through the github.com web interface.
- Navigate to the file within
jekyll/jekyll-adminthat you'd like to edit.
- Click the pencil icon in the top right corner to edit the file
- Make your proposed changes
- Click "Propose file change"
- Click "Create pull request"
- Add a descriptive title and detailed description for your proposed change. The more information the better.
- Click "Create pull request"
That's it! You'll be automatically subscribed to receive updates as others review your proposed change and provide feedback.
Submitting a pull request via Git command line
- Fork the project by clicking "Fork" in the top right corner of
- Clone the repository locally
git clone https://github.com/<you-username>/jekyll-admin.
- Create a new, descriptively named branch to contain your change (
git checkout -b my-awesome-feature).
- Hack away, add tests. Not necessarily in that order.
- Make sure everything still passes by running
script/cibuild(see the tests section below)
- Push the branch up (
git push origin my-awesome-feature).
- Create a pull request by visiting
https://github.com/<your-username>/jekyll-adminand following the instructions at the top of the screen.
Proposing updates to the documentation
We want the Jekyll Admin documentation to be the best it can be. We've open-sourced our docs and we welcome any pull requests if you find it lacking. Any time you propose a code change, you should also include updates to the documentation and tests within the same pull request.
If your contribution changes any Jekyll Admin behavior, make sure to update the documentation. Documentation lives in the
/docs folder (spoiler alert: it's a Jekyll site!). If the docs are missing information, please feel free to add it in. Great docs make a great project. Include changes to the documentation within your pull request, and once merged, the site will be updated.
How to submit changes
Previewing changes locally
- Open localhost:4000/jekyll-admin in your browser