Contributing file

main
Bob Mottram 2019-11-29 10:47:18 +00:00
parent 582649c720
commit 06ef125e89
1 changed files with 37 additions and 0 deletions

37
CONTRIBUTING.md 100644
View File

@ -0,0 +1,37 @@
## License
By submitting code, documentation or artwork you agree that it will be licensed under the GNU AGPL license version 3 or later.
## Security Vulnerability Disclosure
Create an issue on https://gitlab.com/bashrc2/epicyon/issues. If the vulnerability is especially sensitive then send an XMPP message to **bob@freedombone.net** or a Matrix message to **@bob:matrix.freedombone.net**.
## Code of Conduct
The code of conduct can be found [here](code-of-conduct.md).
## Submitting Bugs, Feature Requests or Merge Requests
Submit to https://gitlab.com/bashrc2/epicyon/issues
You can also post patches in the old-fashioned style via email to **bob@freedombone.net**. Include **[Epicyon]** in the subject line, otherwise it may be ignored.
## Development Style
Try not to add extra package dependencies. Dependency proliferation is something which this project is trying to avoid. Large numbers of dependencies create maintenance problems.
Avoid javascript. The web interface should be usable in a Tor browser with NoScript enabled and also in Lynx.
If you are adding or changing the web interface, make sure that your changes make sense when viewed within a Lynx browser.
## Translations
Translations can be added in json format to the **translations** directory. No other modifications to the software are required. You can use **en.json** as a template for creating a new translations file.
## Themes
To create a new theme you can manually edit **epicyon.css** on a running server, then when you are happy with the changes create a new function within **theme.py** and call it from **setTheme**.
If you need customized icons then add them within **img/icons** as a subdirectory.
Add translations for the name of your new theme, then within **webinterface.py** edit the **themesDropdown** string to add your theme.