Skip to content

Using Github

Jump to bottom
Gandalf86 edited this page Apr 11, 2018 · 44 revisions

We are currently trying to use Github for project organization. This is a short overview over the different features offered here.

Features

  1. Organization: The current organization name is "wispproject". An organization is a container for repositories.
  2. Repository: A repository can be seen as a sub-project inside the organization. Each repository has its own code tree, its own wiki, issue tracker and its own project boards. Repositories for Wisp will be the wallet code, website code and the 'doc' repository which contains all remaining documentation.
  3. Teams: Access to different repositories is managed via teams. The currently available teams are core developers, web developers, writers and artists.
  4. A "Project" is a project board for managing open issues. For more info, see: https://help.github.com/articles/about-project-boards/ . Each repository can have its own project boards, but there can also be organization-wide project boards that cover all repositories. Note that moving an issue between different columns in a board is displayed in the respective issue, every time, so moving issues between columns should be done carefully ;)
  5. Wiki: You are currently looking at it! There is a list of pages in this wiki on the right side.
  6. Issues: Issues are like tickets that indicate that something specific should be done. For example you can use it to make specific suggestions or report errors. There are separate issue trackers for the documentation, website and the wallet. Tickets can be taken care of by members that have access to the respective repository.

Membership levels

There are 4 kinds of membership levels:

  1. Owner: Owners have write access to everything. They can delete the entire organization, administrate teams, delete stuff, and have write access to all repositories. They are also the only people who can invite new members into the organization. Since this is a security-critical role, only a few highly trusted members with high security standards should have this role.
  2. Member: Organization members are grouped into teams with different permissions.
  3. Collaborator: Collaborators can be given access to specific repositories without requiring them to be in a team. Members of teams that have the "Admin" permission for a repository can invite external collaborators.
  4. Every Github user can create new "issues" to contribute to the project by reporting errors and pointing out things that should be done. For simple suggestions or general discussion, please use the Discord.

Proposals

If you want to make a non-technical proposal regarding the project organization or to report an error in the documentation, please use the 'doc' issue tracker: https://github.com/wispproject/doc/issues

Repositories for the wallet and website will be created in the future, where you will then be able to make specific change requests or proposals or report bugs.

Security

It is recommended for all members of the Wisp organization to enable two-factor authentication (2FA). For more information, see https://help.github.com/articles/securing-your-account-with-two-factor-authentication-2fa/

There is also an option to require this for any user who wants to become a member. This is currently disabled.

Clone this wiki locally