overleaf/CONTRIBUTING.md

64 lines
3.5 KiB
Markdown
Raw Normal View History

2014-02-08 14:40:56 -05:00
Contributing to ShareLaTeX
==========================
2014-02-13 08:21:36 -05:00
Thank you for reading this! If you'd like to report a bug or join in the development
of ShareLaTeX, then here are some notes on how to do that.
2014-02-08 14:40:56 -05:00
2014-02-15 13:31:12 -05:00
*Note that ShareLaTeX is actually made up of many seperate repositories (a list is available
2014-02-21 12:53:58 -05:00
[here](https://github.com/sharelatex/sharelatex/blob/master/README.md#other-repositories)).*
2014-02-15 13:31:12 -05:00
2014-02-13 08:21:36 -05:00
Reporting bugs and opening issues
---------------------------------
2014-02-08 14:40:56 -05:00
2017-08-05 15:09:55 -04:00
If you'd like to report a bug or open an issue then please:
2014-02-08 14:40:56 -05:00
2014-02-24 10:24:47 -05:00
1. **Find the correct repository.** ShareLaTeX is split across multiple different repositories, each containing a different service (you can find a list of [all repositories here](https://github.com/sharelatex/sharelatex/blob/master/README.md#other-repositories)). If you know the bug only applies to one service, then please open an issue in that repository. For general bugs and issues that span more than one service, please open an issue in the [sharelatex/sharelatex](https://github.com/sharelatex/sharelatex) repository.
2014-02-13 08:21:36 -05:00
2. **Check if there is an existing issue.** If there is then please add
any more information that you have, or give it a 👍.
2014-02-08 14:40:56 -05:00
2014-02-13 08:21:36 -05:00
When submitting an issue please describe the issue as clearly as possible, including how to
reproduce the bug, which situations it appears in, what you expected to happen, and what actually happens.
If you can include a screenshot for front end issues that is very helpful.
2014-02-08 14:40:56 -05:00
Pull Requests
-------------
2014-02-23 16:38:02 -05:00
See [our wiki](https://github.com/sharelatex/sharelatex/wiki/Developer-Guidelines)
for how to manage the ShareLaTeX development environment and for our developer guidelines.
2014-02-21 15:36:33 -05:00
2014-02-08 14:40:56 -05:00
We love pull requests, so be bold with them! Don't be afraid of going ahead
2014-02-13 08:21:36 -05:00
and changing something, or adding a new feature. We're very happy to work with you
to get your changes merged into ShareLaTeX.
If you've got an idea for a change then please discuss it in the open first,
either by opening an issue, or by joining us in our
[development chat room](http://www.hipchat.com/g1nJMcj7b).
2014-02-24 10:24:47 -05:00
If you're looking for something to work on, then take a look at our [development roadmap](https://github.com/sharelatex/sharelatex/wiki/Development-Roadmap), or have a look at the open issues in any of the repositories listed [here](https://github.com/sharelatex/sharelatex/blob/master/README.md#other-repositories).
2014-02-13 08:21:36 -05:00
Developer Chat Room
-------------------
If you want to ask any questions in real-time, or get a feel for what's going on
then please drop into our [development chat room](http://www.hipchat.com/g1nJMcj7b).
If no one is online then you can still leave a message that will hopefully get a reply
when we return.
Security
--------
Please do not publish security vulnerabilities publicly until we've had a chance
to address them. All security related issues/patches should be sent directly to
team@sharelatex.com where we will attempt to address them quickly. If you're
2014-02-13 08:21:36 -05:00
unsure whether something is a security issue or not, then please be cautious and
contact us at team@sharelatex.com first.
2014-02-08 14:40:56 -05:00
2014-02-24 07:55:27 -05:00
Contributor License Agreement
-----------------------------
2017-08-05 17:33:16 -04:00
Before we can accept any contributions of code, we need you to agree to our
2014-02-24 07:55:27 -05:00
[Contributor License Agreement](https://sharelatex.wufoo.com/forms/sharelatex-contributor-license-agreement/).
This is to ensure that you own the copyright of your contribution, and that you
agree to give us a license to use it in both the open source version, and the version
of ShareLaTeX running at www.sharelatex.com, which may have additional changes.