Skip to content

Getting Involved

Elio Qoshi edited this page Mar 20, 2018 · 1 revision

How to contribute

There are different ways on how to get involved with Identihub and our community. Below are some of the ways you can get involved with the growing Identihub community, but if you want to contribute in a way that is not documented here feel free to contact us at hello@ura.design.

  • Filing a new bug issue
  • Improving source code on GitHub
  • Testing the latest version locally
  • Translating our website

Report an issue

In case you have faced any unexpected results after using Identihub or having something new to propose, you can always file a new issue. You can open a new issue here: https://github.com/uracreative/identihub/issues. Please make sure that someone else has not filed the same issue as you in the past. Don't forget to check closed issues too.

Documentation

Software documentation is written text or illustration that accompanies any computer software or is embedded in the source code. It either explains how a software like Identihub operates or how to use it, but is also includes ways of community members and partners to interact directly or indirectly with the software. Documentation is an important part of software engineering and community building of Identihub as a project. Types of documentation include, but are not limited to :

  • Requirements – Statements that identify attributes, capabilities, characteristics, or qualities of a system. This is the foundation for what will be or has been implemented;
  • Architecture/Design – Overview of software. Includes relations to an environment and construction principles to be used in design of software components;
  • Technical – Documentation of code, algorithms, interfaces, and APIs;
  • End user – Manuals for the Identihub end-user, system administrators and support staff;
  • Community building. Interested in helping us in documenting Identihub better? Join the discussion today: https://chat.ura.design/.

Design

Our community is growing and the need for design as well! IF you can help create visual assets or even mockup upcoming Identihub features, we welcome them!

QA

If you are considering contributions for Identihub, testing is one of the major ways to help us improve the software. By testing Identihub on different servers or locally you can give us feedback by filing an issue on what is not running properly. You can file a new issue here: https://github.com/uracreative/identihub/issues. Please make sure that someone else has not filed the same issue as you in the past. A quick search describing your issue can help most of the time.

Tests

We use TravisCI for tests. If you would like to create tests and automate processes, please be our guest!

Outreach

Identihub is consisted of a community of people that contribute to improve the project. In case you are considering to create a new local community please make sure to introduce yourself on Mattermost , our main communications channel. You might find more people near you with the same interests. You may organize:

  • Meetups
  • Localization sprints to bring the website in your language
  • Release parties

Feel free to organize an event of your own that is not listed above. Make sure you document your events with a few pictures at least. You can share them on our Chat channels or on other web platforms by using the #Identihub hashtag. If you need swag for the event, ask us, we might be able to help out.

l10n

This weird code means 'localization' and refers to all the work done by our community for the translation of Identihub as a software and other related materials such as www.identihub.co, documentations and more. We will soon add more information here on how you can translate these assets in your language.

Communication channels

Chat

Mattermost is an open source software and is our main communication channel. You can access it through https://chat.ura.design/ and create a new account. Otherwise, you need to download Mattermost software from https://about.mattermost.com/download/ by following the instructions on their website. Mattermost is also available as a mobile app.

Email

If you have any questions on how to contribute don't hesitate to reach out to us: hello@ura.design.

Social networks

We try to avoid social media for communication purposes (remember our main communication channel is Mattermost), but if you want to get our attention on Twitter please use #Identihub and/or follow @identihub.

Code of Conduct

At Identihub diversity, inclusion and being respectful to each other are fundamental elements of our DNA. We try to take these matters seriously so we can avoid any misunderstandings between members of the community. Having said that, please carefully read our Code of Conduct before you start contributing: https://github.com/uracreative/identihub/blob/dev/CODE_OF_CONDUCT.md.

License of your contributions

Below are the licenses for different kind of contributions we receive from our community.

Code contributions

All contributions from our community to our code are released under a AGPL 3.0 license: https://www.gnu.org/licenses/agpl-3.0

Text, graphics and photos

Translations of our website, adaptations of posters and photos in other languages are only some examples of contributions from our community. All these materials (and more) are licensed under a Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license: https://creativecommons.org/licenses/by-sa/4.0/