Forked from Joystream/community-repo https://github.com/Joystream/community-repo

Oleksandr Korniienko a1f538f9f9 Implement Validator Report and Live Stats from WS Endpoint Typescript React App vor 3 Jahren
bounties-overview c18e7d61ef bounty json update - 15 June 2021 (B) vor 3 Jahren
bounties-reports d61d7cf585 bounty payments 4 vor 3 Jahren
community-contributions a1f538f9f9 Implement Validator Report and Live Stats from WS Endpoint Typescript React App vor 3 Jahren
council-reports 9253024f35 Create Sumer Council 11 Report - 06-07-2021.md vor 3 Jahren
council-survey 11961bfb0a Update README.md vor 3 Jahren
documentation 17b5d29c72 Merge pull request #154 from mochet/CMdiscordusernames vor 3 Jahren
img 76a2250392 moved dir of entry vor 3 Jahren
joystream-api b88c355678 set correct endpoint vor 3 Jahren
operations 29d682e924 Create operations_task_list.md vor 3 Jahren
platform_reports 0cb537fb22 Create state_of_joystream_template.md vor 3 Jahren
rules c84c50a8f4 Merge pull request #229 from maxlevush/Content_Curator_Tasks vor 3 Jahren
storage-report 629536cc34 report 7 vor 3 Jahren
submission-log 423a901205 Fixed formatting issues vor 4 Jahren
tokenomics-reports 33de4a010f Add council #12 tokenomics report vor 3 Jahren
workinggroup-reports 31a2c84684 Merge pull request #119 from mochet/wgreport vor 3 Jahren
.gitignore 9a026a9751 Add .idea folder to .gitignore vor 3 Jahren
LICENSE 96dca35cda Initial commit vor 4 Jahren
README.md 0446e27fd2 Merge pull request #134 from traumschule/banner vor 3 Jahren

README.md

Joystream Community Repository for reports, researches, tools and other community contributions.

Table of Contents

Overview

The Joystream Community Repo is meant both as a resource for the community members of the Joystream project, and a place to submit their work or contributions.

If a KPI requires submitting a deliverable, eg. reports or some code, it is expected that a PR is made to this repo in order to qualify.

Although the community is meant to control the repo, Jsgenesis will approve and merge any pull requests for now. Note that the repo is licensed under GPLv3.

Community Bounties

Community Bounties are bounties made available for the community to work on, with a reward available for completing some or all of the work for each bounty. Bounties are created by Jsgenesis and managed by the council. The bounties can be for a variety of tasks including coding, producing documentation or producing media content. Community Bounties are submitted via a proposal on the platform and may also include a Pull Request within this repo.

The forum is the primary place for discussion of bounties, and you can look through the "Joystream Bounties" forum category for more details about current bounties. Each time a new bounty is added there will be a forum thread created for discussion of the bounty: https://testnet.joystream.org/#/forum/categories/10

If you have questions about a bounty or want to apply for a bounty, you should primarily use the forum. but you can also ask on Telegram. If you plan to work on a bounty, you should let others know this via the forum so that multiple people do not work on the same thing.

You can read more about Community Bounties on the Joystream Helpdesk repo: https://github.com/Joystream/helpdesk/tree/master/roles/builders#community-bounties

Workflow

The workflow for changing the repo depends on the reason and purpose behind the change. A consistent part is for the contributor to fork the repo, and create a pull request to the applicable branch.

KPI Related Submissions

When a KPI requires a deliverable to be successful, the following steps must be made:

  • A pull request is made to the master branch.
  • A proposal is made to the Joystream testnet.
    • The proposal (Text, or in some cases, Spending) contains a link to the PR and other relevant information
    • When (if) the proposal is voted through, @bwhm and @blrhc is tagged
    • The time of the latest commit will be used as the time of submission
  • The PR is reviewed, and as long as it does not contain anything malicious or does not comply with license, it is merged.
  • The submission is added to the Submission Log

Individual Submissions

If the deliverable is made by an individual, eg. for an existing or upcoming funding proposal, the following steps must be made:

  • A pull request is made to the community branch, in a new folder within the Community Contributions directory.
    • Example: Bot project - Author Name
  • A proposal is made to the Joystream testnet.
    • The proposal (Text, or in some cases, Spending) contains a link to the PR and other relevant information.
    • When (if) the proposal is voted through, @bwhm and @blrhc is tagged
  • The PR is reviewed, and as long as it does not contain anything malicious or does not comply with the license of the repo, it is merged.
  • The submission is added to the Submission Log

Jsgenesis Submissions

If a member of the Jsgenesis team wants to make changes to the repo, the following steps must be taken:

  • A pull request is made to the master branch
  • A Text proposal is made to the Joystream testnet.
    • The proposal contains a link to the PR and other relevant information
    • When (if) the proposal is voted through, the PR is merged.
  • The submission is added to the Submission Log

Revisions & Improvements of Submissions

  • For general updates (updating links, text) these can just be gathered occasionally and submitted as a rolling update like this example: https://testnet.joystream.org/#/proposals/14 This does mean that it will take some time for the PRs to be approved by the council.
  • In the event of some highly important change, a proposal could be made so that the matter is addressed more quickly than waiting for a rolling update
  • If users want to be paid for updates or corrections, then they should open a PR (or multiple PRs) and link to it in a spending proposal, when this is approved it would have the same effect as approving the PR (which still has to be reviewed by Jsgenesis)
  • As an example, if a user wants to add functionality to the telegram bot and be paid for it, they can open a PR and create a spending proposal linking to the PR

Current Directories

council-reports

This folder can be used for creating council reports. The council reports submitted should be formatted in the following way: Council Round #n - DD/MM/YYYY - Council Report.md

community-contributions

This folder can be used for community coded bots and projects and anything that doesn't fit elsewhere. Each submission should be in a unique folder within this directory.

documentation

This folder can be used for documentation.

submission-log

This folder can be used for maintaining a log of submissions. If the testnet is started from fresh, a new file should be made. Each entry in the log should include the Joystream username of the submission, a link to the proposal, a link to the PR and the amount of tokens awarded to the user (if applicable). #1 - Rome Testnet - Community Repo Submission Log.md

tokenomics-reports

This folder can be used for creating tokenomics reports, tokenomics reports are to be submitted during each Council Round. The tokenomics reports submitted should be formatted in the following way: Council Round #n - DD/MM/YYYY - Tokenomics Report.md

workinggroup-reports

This folder can be used for creating reports specific to working groups like the storage or curator working groups.