Skip to content
This repository was archived by the owner on Feb 21, 2022. It is now read-only.

Latest commit

 

History

History
90 lines (50 loc) · 3.08 KB

CONTRIBUTING.md

File metadata and controls

90 lines (50 loc) · 3.08 KB

Contributing

How to contribute to zUIx

Did you find a bug?

  • Ensure the bug was not already reported by searching on GitHub under Issues.

  • If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a title and clear description, as much relevant information as possible, and a code sample or an executable test case demonstrating the expected behavior that is not occurring.

Did you write a patch that fixes a bug?

  • Open a new GitHub pull request with the patch.

  • Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.

Did you fix whitespace, format code, or make a purely cosmetic patch?

Changes that are cosmetic in nature and do not add anything substantial to the stability, functionality, or testability of zUIx will generally not be accepted unless discussed via the issue tracker.

Do you intend to add a new feature or change an existing one?

File a new enhancement issue.

Do you have questions about the source code?

File a new question issue.

Coding styles and conventions

This project follows standardjs.com coding rules. The build script also includes ESLint checks that are mainly based off the eslint-config-google. You may find out that some of these rules are not fully respected in the existing code, but this will be fixed from time to time.

Getting started with zUIx source code

Clone zUIx repository and install dependencies:

npm install
Build

Build source and create minified version in ./dist/js folder:

npm run build

this will also generate, starting from JSDoc comments, the JSON formatted API files in the ./docs/app/content/api/data folder and TypeScript definition file in the ./dist/js folder.

To submit a new release

npm run release <newversion> | major | minor | patch | premajor | preminor | prepatch | prerelease

if passing CI tests this will also publish npm packages and update documentation website files in gh-pages branch. The script run on the CI server side is

npm run deploy
Website

Website source files are located in the zuix-website folder which is a submodule pointing to the gh-pages branch.

cd zuix-website && npm install

Website files are generated in the ./docs folder issuing the command

npm run build  # to be run from ./zuix-website folder

Any change made to the website must be pushed to the gh-pages branch:

git push origin gh-pages

For complete instructions see gh-pages repository.

Join zUIx team!

zUIx is a volunteer effort. We encourage you to pitch in and join the team!

Thanks! ❤️ ❤️ ❤️