Skip to content

Latest commit

 

History

History
104 lines (67 loc) · 3.97 KB

CONTRIBUTING.md

File metadata and controls

104 lines (67 loc) · 3.97 KB
Raw

Contributing Guide

General Guidelines

Thanks for understanding that English is used as a shared language in this repository. Maintainers do not use machine translation to avoid miscommunication due to error in translation. If description of issue / PR are written in non-English languages, those may be closed.

It is of course fine to use non-English language, when you open a PR to translate documents and communicates with other users in same language.

Pull Request Guidelines

  • The main branch is the latest stable version release. All development should be done in dedicated branches.

  • Checkout a topic branch from the relevant branch, e.g. main, and merge back against that branch.

  • Work in the src folder and DO NOT checkin dist in the commits.

  • If adding new feature:

    • Add accompanying test case.
    • Provide convincing reason to add this feature. Ideally you should open a suggestion issue first and have it greenlighted before working on it.

  • If fixing a bug:

    • Provide detailed description of the bug in the PR. Live demo preferred.
    • Add appropriate test coverage if applicable.

  • It's OK to have multiple small commits as you work on the PR - we will let GitHub automatically squash it before merging.

  • Make sure pnpm test passes. (see development setup)

Work Step Example

  • Fork the repository from intlify/bridging !
  • Create your topic branch from main: git branch my-new-topic origin/main
  • Add codes and pass tests !
  • Commit your changes: git commit -am 'Add some topic'
  • Push to the branch: git push origin my-new-topic
  • Submit a pull request to main branch of intlify/bridging repository !

Development Setup

You will need Node.js version 14.16+, and PNPM.

After cloning the repo, run:

$ pnpm i # install the dependencies of the project

A high level overview of tools used:

Scripts

pnpm test

The test script calls the following npm scripts:

  • test:i18n9:unit: unit test @intlify/vue-i18n-bridge on vue-i18n v9
  • test:i18n8:unit: unit test @intlify/vue-i18n-bridge on vue-i18n v8
  • test:router4:unit: unit test @intlify/vue-router-bridge on vue-router v4
  • test:router3:unit: unit test @intlify/vue-router-bridge on vue-router v3

Project Structure

This repository employs a monorepo setup which hosts a number of associated packages under the packages directory:

  • vue-i18n-bridge: Vue I18n bridging for Vue 2 & Vue 3
  • vue-router-bridge: Vue Router bridging for Vue 2 & Vue 3

Contributing Tests

Unit tests are collocated with directories named test on examples/**/. Consult the Vitest docs and existing test cases for how to write new test specs.

Financial Contribution

As a pure community-driven project without major corporate backing, we also welcome financial contributions via GitHub Sponsors

Funds donated via GitHub Sponsors and Patreon go to support kazuya kawaguchi full-time work on Intlify.

Credits

Thank you to all the people who have already contributed to Intlify project and my OSS work !