Skip to content

Latest commit

 

History

History
74 lines (47 loc) · 3.02 KB

CONTRIBUTING.md

File metadata and controls

74 lines (47 loc) · 3.02 KB
Raw

Contributing

When contributing to this repository, please first discuss the change you wish to make by opening a new issue.

Please note we have a code of conduct, please follow it in all your interactions with the project.

Owner

PermissionsSwiftUI is created by Jingwen (Jevon) Mao

The current owner is Jingwen (Jevon) Mao

Email: jingwenmao@g.ucla.edu

Discord: Jevon#2448

Pull Request Process

  1. Find an issue to work on

  2. If you want, you can open a new issue or email me about a feature or bug fix

  3. Fork and clone this repository

  4. Make a new branch and name it with issue number + short description (ex. #23-feature-new-color)

  5. DOCUMENT all new APIs, and write code comment if needed

  6. Open a pull request

  7. If needed, update the README.md with details of changes of APIs

Branch Protection

We have branch protection in place for main branch, I will review and merge your PR if all CI checks have passed. The CI checks are automatically triggered on pull request or push to main branch, and may include: build, unit tests, format linting, documentation coverage, and Cocoapods linting.

Label Meanings

PermissionsSwiftUI community uses several different tags to efficiently categorize and manage issues.

work in progress

Any issue labeled with this tag means that it is already work in progress, either by the owner or other contributors. While discussion and comments are still welcome, it usually means that this issue is not open for contributing.

possible bug

Issue opened with bug template will automatically be labeled with the possible bug tag. A possible bug that has not been reviewed by a maintainer or the owner, and will not yet be worked on.

confirmed bug

A confirmed bug label means that the bug has been reviewed and confirmed by maintainers, and will be worked on to be fixed.

feature request

Issue opened with the feature template will automatically be labeled with this tag. It is a request, or a pitch, for a new feature, but the request has not been reviewed by a maintainer or the owner yet.

enhancement

This tag is an evolution of the feature request tag. The feature request has been reviewed and confirmed by maintainers, and will be implemented in future versions.

good first issue & intermediate quest & hard quest

Bugs and features that need to be worked on are also called "quest", which is a name inspired by many RPG games. Those represent the approximate difficulty and complexity of the given issue.

Releasing and Deploying

For each numbered version release, it is important to follow semantic versioning guidelines.

  • Bump version in PermissionsSwiftUI.podspec
  • Update changelog with changes (ignore for now)
  • Commit and push changes
  • Tag new version:
$ git tag -a <VERSION> -m "<MESSAGE>"
$ git push origin --tags
  • Deploy to Cocoapods:
pod trunk push --allow-warnings

The documentation will be automatically generated (Jazzy) and deployed to Github pages by a Github Action that triggers on each new release.