Skip to content
This repository has been archived by the owner on Aug 14, 2022. It is now read-only.

Latest commit

 

History

History
66 lines (45 loc) · 2.59 KB

CONTRIBUTING.md

File metadata and controls

66 lines (45 loc) · 2.59 KB
Raw

scad-api

OpenSCAD like modeling API for OpenJSCAD - Contributing Guide

This library is part of the JSCAD Organization, and is maintained by a group of volunteers. We welcome and encourage anyone to pitch in but please take a moment to read the following guidelines.

  • If you want to submit a bug report please make sure to follow the Reporting Issues guide. Bug reports are accepted as Issues via GitHub.

  • If you want to submit a change or a patch, please read the contents below on how to make changes. New contributions are accepted as Pull Requests via GithHub.

  • We only accept bug reports and pull requests on GitHub.

  • If you have a question about how to use OpenJSCAD, then please start a conversation at the OpenJSCAD.org User Group. You might find the answer in the OpenJSCAD.org User Guide.

  • If you have a change or new feature in mind, please start a conversation with the Core Developers and start contributing changes.

Thanks!

The JSCAD Organization

Making Changes

First, we suggest that you fork this GIT repository. This will keep your changes separate from the fast lane. And make pull requests easier.

Once forked, clone your copy of the OpenJSCAD library.

git clone https://github.com/myusername/scad-api.git
cd scad-api

We suggest downloading NPM. This will allow you to generate API documents, and run test suites.

Once you have NPM, install all the dependencies for development.

npm install

And, run the test cases to verify the library is functional.

npm test

The project is structured as:

  • src/*.js : library and test suite source code
  • dist/index.js : generated library for distribution

You can now make changes to the library, as well as the test suites.

If you intend to contribute changes back to JSCAD then please be sure to create test cases.

Done? Great! Push the changes back to the fork.

git commit changed-file
git add test/new-test-suite.js
git commit test/new-test-suite.js
git push

Finally, you can review your changes via GitHub, and create a pull request.

TIPS for successful pull requests:

  • Commit often, and comment well
  • Follow the JavaScript Standard Style
  • Create test cases for all changes
  • Verify that all tests suites pass

WOW! Thanks for the cool code.