2013-10-19 12:24:36 +00:00
|
|
|
Contributing
|
|
|
|
|
============
|
|
|
|
|
|
|
|
|
|
I appreciate any help and love pull requests. Here are some things
|
|
|
|
|
you need to respect:
|
|
|
|
|
|
|
|
|
|
* no hard-wired external services
|
|
|
|
|
* no support for ancient browsers (e.g. IE6-9)
|
|
|
|
|
|
2013-10-31 10:57:34 +00:00
|
|
|
If you create a feature request, start a new branch. If you fix an issue,
|
|
|
|
|
start off the *master* branch and pull request against the master. I'll
|
|
|
|
|
cherry-pick/backport the fix onto the current legacy (maintenance) release.
|
2013-10-19 12:24:36 +00:00
|
|
|
|
2013-10-31 10:57:34 +00:00
|
|
|
To set up a development environment, see
|
|
|
|
|
[docs/DEVELOPMENT.md](https://github.com/posativ/isso/blob/master/docs/DEVELOPMENT.md)
|
2013-10-19 12:24:36 +00:00
|
|
|
|
|
|
|
|
|
2013-10-31 10:57:34 +00:00
|
|
|
Reporting Issues
|
|
|
|
|
----------------
|
2013-10-19 12:24:36 +00:00
|
|
|
|
2013-10-31 10:57:34 +00:00
|
|
|
* **Disqus import fails**
|
2013-10-19 12:24:36 +00:00
|
|
|
|
2013-10-31 10:57:34 +00:00
|
|
|
If `isso import /path/to/disqus.xml` fails, please do *NOT* attach the raw
|
|
|
|
|
dump file to GH:Issues. Please anonymize all IP addresses inside the
|
|
|
|
|
`<ipAddress>` tag first, as second step, replace all `<email>` addresses
|
|
|
|
|
with a generic one.
|
2013-10-19 12:24:36 +00:00
|
|
|
|
2013-10-31 10:57:34 +00:00
|
|
|
If you can't do this, please send the dump to `info@posativ.org` (you find
|
|
|
|
|
my GPG key on the servers).
|
2013-10-19 12:24:36 +00:00
|
|
|
|
2013-10-31 10:57:34 +00:00
|
|
|
* **embed.min.js-related issues**
|
2013-10-19 12:24:36 +00:00
|
|
|
|
2013-10-31 10:57:34 +00:00
|
|
|
If you get a cryptic JavaScript error in the console, embed `embed.dev.js`
|
|
|
|
|
instead of `embed.min.js` and create an issue with ±10 lines of code around
|
|
|
|
|
the error.
|
2013-10-19 12:24:36 +00:00
|
|
|
|
2013-10-31 10:57:34 +00:00
|
|
|
* **isso-related issues**
|
2013-10-19 12:24:36 +00:00
|
|
|
|
2013-10-31 10:57:34 +00:00
|
|
|
Copy and paste traceback into a ticket and provide some details of your usage.
|
