This project adheres to the Contributor Covenant Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to [email protected].
All changes should be made via pull requests on GitHub.
When issuing a pull request, please add a summary of your changes to
the CHANGELOG.md file.
We follow the same syntax as CocoaPods' CHANGELOG.md:
- One Markdown unnumbered list item describing the change.
- Two trailing spaces on the last line describing the change.
- A list of Markdown hyperlinks to the contributors to the change. One entry per line (and there's usually just one contributor).
- A list of Markdown hyperlinks to the issues the change addresses. One entry per line (and there's usually just one hyperlink). Don't link to PRs here.
- All CHANGELOG.md content is hard-wrapped at 80 characters.
Jazzy heavily relies on integration tests, but since they're considerably large and noisy, we keep them in a separate repo (realm/jazzy-integration-specs).
If you're making a PR towards jazzy that affects the generated docs, please update the integration specs using the following process:
git checkout master
git pull
git checkout -
git rebase master
rake bootstrap
bundle exec rake rebuild_integration_fixtures
cd spec/integration_specs
git checkout -b $jazzy_branch_name
git commit -a -m "update for $jazzy_branch_name"
git push
cd ../../
git commit -a -m "update integration specs"
git pushYou'll need push access to the integration specs repo to do this. You can request access from one of the maintainers when filing your PR.
You must have Xcode 12.5 installed to build the integration specs.
When changes are landed in the https://github.com/jpsim/SourceKitten repo the SourceKitten framework located in jazzy must be updated.
The following may be executed from your jazzy/ directory.
cd SourceKitten
git checkout master
git pull
cd ..
rake sourcekitten
git add .
git commit -m "..."