Skip to content

Latest commit

 

History

History
72 lines (52 loc) · 2.3 KB

CONTRIBUTING.md

File metadata and controls

72 lines (52 loc) · 2.3 KB
Raw

Contributing to objc2

Thank you for your interest in contributing! There are many ways to contribute and we appreciate all of them.

git submodules

The icrate crate contains a submodule pointing to madsmtm/icrate-generated. This exists to keep the primary repository free from the clutter inherently associated with storing generated files in git, while still allowing change-tracking of said files.

You should consider whether you want a shallow or a full checkout of the generated files - the default is to do a shallow clone, since the repository can become quite large over time.

# Shallow clone
git submodule update --init
# Full clone
git submodule update --init --no-recommend-shallow

See the excellent git documentation on submodules, or the manpage for git-submodule for further details on how submodules work.

Updating the git submodule

When making changes to header-translator, you must update the git submodule manually and push your changes to a fork of icrate-generated (you do not need to submit a PR to that repo).

We try to maintain a linear history in that repo, in a fashion such that every ref that is ever referenced from the HEAD branch in this repository, is reachable from the HEAD branch that repository. This will probably mean you'll have to rebase more often.

If you're confused about this, don't worry too much about it, if you enable "Allow edits by maintainers" we can fix it for you.

Release checklist

Copy and fill out the following checklist into the release PR:

- [ ] The branch is named `new-versions`, such that the full CI will run.
- [ ] Changelogs have only been modified under the `Unreleased` header.
- [ ] Version numbers are bumped in the following order:
    - `objc2-proc-macros`
    - `objc-sys`
    - `objc2-encode`
    - `block-sys`
    - `objc2`
    - `block2`
    - `icrate`
- Local tests have been run (see `helper-scripts/test-local.fish`):
    - [ ] macOS 10.14.6 32bit
    - [ ] iOS 9.3.6, 1st generation iPad Mini

Post merge:
- [ ] A tag is created on the merge commit for each new version.