Skip to content

Latest commit

 

History

History
97 lines (74 loc) · 4.73 KB

CONTRIBUTING.md

File metadata and controls

97 lines (74 loc) · 4.73 KB

Contribution Guideline

Thank you for getting interested in contribution to this project! We really appreciate it. 😊

Table of Contents

Submit Bug Reports or Feature Requests

Tip

If you are not used to do, this section is for you.

Translate the Project

We accept translations through Weblate:

Alternatively, you can fork this repository, edit the *.po files directly, and submit changes through pull requests.

Note

Strings in the translation files are updated automatically if they're changed in the source code.

Things to happen when strings are changed in the source code:

Propose Code Changes

We accept changes to the source code through pull requests―even a small typo fix is welcome.

Tip

Again, the guideline by elementary would be helpful here too.

Coding Style

We follow the coding style of elementary OS and its Human Interface Guidelines. Try to respect them.

Manage the Project

Release Flow

Works in Project Repository

  • Repository URL: https://github.com/ryonakano/reco
  • Decide the version number of the release
  • Create a new branch named release-X.Y.Z from the latest origin/main (X.Y.Z is the version number)
  • See changes since the previous release: git diff $(git describe --tags --abbrev=0)..release-X.Y.Z
  • Perform changes
    • Write a release note in data/reco.metainfo.xml.in
      • Refer to the Metainfo guidelines by Flathub
      • Credits contributors with their GitHub username
        • Translation contributors are excluded because some don't have a GitHub account. Just writing Update translations is fine
    • Bump version in meson.build
    • Update screenshots if there are visual changes between releases
  • Create a pull request with the above changes
  • Merge it once the build succeeded
  • Create a new release on GitHub
    • Create a new tag named X.Y.Z
    • Release title: <Project Name> X.Y.Z Released
    • It's fine to reuse the release note in the metainfo file as the release description. Just convert XML to Markdown
    • Publish it when completed

Works in AppCenter Review repository

  • Repository URL: https://github.com/elementary/appcenter-reviews
  • Fork the repository if you don't have write access to it
  • Create a new branch named com.github.ryonakano.reco-X.Y.Z
  • Perform changes
    • Change commit and version in the applications/com.github.ryonakano.reco.json
      • commit should be the release commit just we published on the project repository
      • version for the relase version
  • Create a pull request with the above changes
  • Await for review approval and merge
  • The new release should be available on AppCenter after some time

Works in Flathub repository

  • Repository URL: https://github.com/flathub/com.github.ryonakano.reco
  • Create a new branch named release-X.Y.Z
  • Perform changes
    • Change url and sha256 in the manifest file
      • These two parameters should point to the tar.gz of the release assets just we published on the project repository
  • Create a pull request with the above changes
  • Merge it once the build succeeded
  • The new release should be available on Flathub after some time