Skip to content

Latest commit

 

History

History
102 lines (75 loc) · 3.71 KB

CONTRIBUTING.md

File metadata and controls

102 lines (75 loc) · 3.71 KB
Raw

Contributing to mark.js

These are the contributing guidelines of mark.js. If you are interested in contributing to the website of mark.js, please head over to the mark.js website contributing guidelines.

1. Issues

If you have a question, problem, feature request or found a bug please open an issue.

1.1 Questions, problems and bugs

For each issue please provide:

  • What kind of browser and version you are using
  • What kind of mark.js version you are using
  • A detailed description
  • The exact steps to reproduce (bugs and problems)
  • A fiddle that demonstrates your issue (if possible)

1.2 Feature requests

Please provide the following information:

  • Your use case, why your enhancement is necessary
  • How to solve it in your opinion

2. Development

2.1 General

Requirements: NodeJS (including npm) and Bower installed.

Before you start developing, you should clone or download this repository and run:

bower install
npm install

Now you are ready to develop.

2.2 ES6 (ES2015) information

mark.js was developed in ECMAScript 6. But as most browsers don't fully support ES6 yet, it has only those features implemented that can be converted "locally" to ES5 using Babel without making a polyfill necessary. This means to forgo using generators, Set, Map, for...of loops etc..

2.3 Grunt tasks

The project is using Grunt as a base, Karma as a task runner and Jasmine (with jasmine-jquery) as a testing framework.

Grunt task Description
dev For development. Will run test on file changes
dist Will trigger compile, test and creates a JSDOC documentation
compile Generates all files in ./dist
test Runs the test and creates test coverage

Note: Run tasks with $ grunt [task] (Replace "[task]" with the actual task name).

2.4 Pull Requests

Pull requests are very much appreciated! 👍

Please note the following things when doing a pull request:

  • Do not change any version
  • Always include a test if possible
    • Add a fixture (test/fixtures/)
    • Add a test (test/specs/)
  • Reference related issues in the pull request description
  • Describe your changes and why they are necessary (if not stated in referenced issues)
  • When changing something inside mark.js, please run $ grunt dist at the end to generate files in dist/
  • Make sure that you format code to fit the code style
  • Pull requests will not be accepted if they worsen test coverage significantly

2.5 Contribution and License Agreement

If you contribute to this project, you are implicitly allowing your code to be distributed under this license. You are also implicitly verifying that all code is your original work.

Thank you for contributing!