Please be courteous and respectful in your communication on IRC, the mailing list, and Github. Humor is appreciated, but remember that some nuance may be lost in the medium and plan accordingly.
When writing commit messages, please bear the following in mind:
- http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
- https://github.com/blog/831-issues-2-0-the-next-generation
Please minimize issue gardening by using the GitHub syntax for closing issues with commit messages.
If you plan to be an active contributor please join our mailing list to coordinate development effort. This coordination helps us avoid duplicating efforts and raises the level of collaboration. For small fixes, feel free to open a pull request without any prior discussion.
Before submitting significant contributions, we ask that sign one of our Contributor License Agreements. This practice ensures that the rights of contributors to their contributions are preserved and protects the ongoing availability of the project and a commitment to make it available for anyone to use with as few restrictions as possible.
There is a version for individuals [HTML or PDF] and a version for those making contributions on behalf of an employer [HTML or PDF].
A completed form can either be sent by electronic mail to [email protected] or via conventional mail at the address below. If you have any questions, please contact us.
Hypothes.is Project 2261 Market St #632 SF, CA 94114
Notes on code style follow for the different languages used in the project. Most important, though, is to follow the style of the code you are modifying, if your edits are not new files.
Please stick to strict, 80-column line limits except for small exceptions that would still be readable if they were truncated.
Eliminate trailing whitespace wherever possible.
Strict PEP8. The project also adheres closely to the Google Python Style Guide.
Generally, no semi-colons are used. This may change. If you're starting a new file, do what you like. Like with Python, please follow the Google JavaScript Style Guide. Additionally, Python-like spacing is followed for blank lines.
Once again, the Google HTML/CSS Style Guide is the place to look.
As JavaScript, above. Plus these additional suggestions:
Parenthesis are Lisp over ALGOL, except when chaining:
Yes:
(merge (parse object))
$(this).css({top: 0}).addClass('red')
No:
merge(parse(object))
Use implicit returns wherever possible. For instance, a good exception would be when using return to short circuit a function on an error condition.
Yes:
if this
that
else
theOtherThing
No:
if this
return that
else
return theOtherThing
Committers are those with push access to the main repository. These people should feel free to commit small changes in good faith. It is expected that these people should read upstream commits made by others when they feel qualified to review the material and comment with any objections, questions or suggestions. In general, these commits should be uncontroversial and do not require up front code review.
Larger changes, and changes being submitted by non-committers, should follow the branching and merging strategy outlined in the next section.
For any non-trivial changes, please create a branch for review. Fork the main repository and create a local branch. Later, when the branch is ready for review, push it to a fork and submit a pull request.
Please use the recommended naming policy for branches as it makes it easier to follow the history back to issues. The recommended template is <issue name>-<slug>.
For instance, 43-browser-extensions would be a branch to address issue #43, which is to create browser extensions.
Discussion and review in the pull request is normal and expected. By using a separate branch, it is possible to push new commits to the pull request branch without mixing new commits from other features or mainline development.
Please try hard to keep extraneous commits out of pull requests so that it is easy to see the intent of the patch!
Please do not merge on feature branches. Feature branches should merge into upstream branches, but never contain merge commits in the other direction. Consider using '--rebase' when pulling if you must keep a long-running branch up to date. It is better to start a new branch and, if applicable, a new pull request when performing this action on branches you have published.