Skip to content

Latest commit

 

History

History
77 lines (47 loc) · 2.14 KB

CONTRIBUTING.md

File metadata and controls

77 lines (47 loc) · 2.14 KB

Contributing

We would love to get contributions from you.

Issues

When creating an issue please try to use the following format.

Good issue reports are extremely helpful, thank you.

One line summary of the issue

Details of the issue.

**Steps to reproduce the behavior**

- List all relevant steps to reproduce the observed behavior.

**Expected behavior**

As concisely as possible, describe the expected behavior.

**Actual behavior**

As concisely as possible, describe the observed behavior.

**Environment**

- Operating system name, version, and build number, such as “iOS 14.0.1 (18A393)”.
- Hardware name and revision, such as “iPhone 11 Pro”.
- Xcode version and build number, such as “12.0 (12A7209)”.
- Any other dependencies, such as third-party keyboard and its version, if it’s applicable.

Pull requests

If you would like to test and/or contribute please follow these instructions.

Workflow

We follow the GitHub Flow Workflow

  1. Fork the repository.
  2. Check out the default branch.
  3. Create a feature branch.
  4. Write code and tests if possible for your change.
  5. From your branch, make a pull request against the default branch.
  6. Work with repository maintainers to get your change reviewed.
  7. Wait for your change to be pulled into the default branch.
  8. Delete your feature branch.

Development

It is useful to use the Sample project to demonstrate new features.

Testing

Use regular XCTest and Swift Package structure.

It is highly recommended to write unit tests for any new features in Lucid's framework. However, the codegeneration isn't unit tested, but rather proven to work with the Sample project.

Submit pull requests

Files should be exempt of trailing spaces and passed all unit tests.

Some important notes regarding the summary line.

  • Describe what was done; not the result.
  • Use the active voice.
  • Use the present tense.
  • Capitalize properly.
  • Do not end in a period. This is a title or subject.

License

By contributing your code, you agree to license your contribution under the terms of MIT license.