From 3e8d087f958192f648ec4dc3877cbd7f64ec7767 Mon Sep 17 00:00:00 2001 From: Oxydixi Date: Tue, 16 Jan 2024 21:25:18 +0300 Subject: [PATCH] menu restructuring --- docs/hacks-and-grants/user-guide.md | 3 + docs/user-guide/architecture.md | 9 + docs/user-guide/git-open-source-hodler.md | 4 + docs/user-guide/instruments-and-utilities.md | 7 + docs/user-guide/motivation.md | 2 + docs/user-guide/objective.md | 2 + docs/working-with-gosh/gosh-web copy 3.md | 1587 +++++++++ docs/working-with-gosh/gosh-web/account.md | 133 + docs/working-with-gosh/gosh-web/create-dao.md | 53 + .../gosh-web/dao-overview.md | 122 + docs/working-with-gosh/gosh-web/dao-set-up.md | 397 +++ docs/working-with-gosh/gosh-web/grh-config.md | 23 + docs/working-with-gosh/gosh-web/members.md | 191 ++ .../gosh-web/proposals-and-voting-in-smv.md | 145 + docs/working-with-gosh/gosh-web/repository.md | 229 ++ docs/working-with-gosh/gosh-web/task.md | 133 + .../gosh-web/working-with-tokens-and-karma.md | 122 + mkdocs.yml | 73 +- site/404.html | 800 ++++- site/acki-nacki/overview/index.html | 884 +++-- site/anytree-all/index.html | 884 +++-- site/empty/index.html | 800 ++++- site/ethereum-L2/overview/index.html | 794 ++++- site/ethereum-L2/user-guide/index.html | 792 ++++- site/hacks-and-grants/overview/index.html | 796 ++++- site/hacks-and-grants/user-guide/index.html | 1089 ++++-- site/index.html | 822 +++-- site/integrations/contracts/index.html | 800 ++++- site/integrations/l2/index.html | 798 ++++- site/integrations/sync/index.html | 798 ++++- site/links/index.html | 800 ++++- .../gosh-smart-contracts/index.html | 796 ++++- .../gosh-wallet/index.html | 796 ++++- .../organizations-gosh-dao-and-smv/index.html | 914 +++-- site/search/search_index.json | 2 +- site/sitemap.xml.gz | Bin 127 -> 127 bytes site/user-guide/architecture/index.html | 1601 +++++++++ .../git-open-source-hodler/index.html | 1591 +++++++++ .../instruments-and-utilities/index.html | 1598 +++++++++ site/user-guide/motivation/index.html | 1592 +++++++++ site/user-guide/objective/index.html | 1592 +++++++++ .../index.html | 988 ++++-- site/working-with-gosh/anytree/index.html | 990 ++++-- .../build-and-sign-images/index.html | 800 ++++- .../docker-extension/index.html | 880 +++-- .../git-remote-helper/index.html | 880 +++-- site/working-with-gosh/gosh-ai/index.html | 1008 ++++-- .../gosh-web copy 3/index.html | 3034 +++++++++++++++++ .../gosh-web/account/index.html | 1804 ++++++++++ .../gosh-web/create-dao/index.html | 1638 +++++++++ .../gosh-web/dao-overview/index.html | 1833 ++++++++++ .../gosh-web/dao-set-up/index.html | 2101 ++++++++++++ .../gosh-web/grh-config/index.html | 1603 +++++++++ site/working-with-gosh/gosh-web/index.html | 1078 +++--- .../gosh-web/members/index.html | 1860 ++++++++++ .../proposals-and-voting-in-smv/index.html | 1801 ++++++++++ .../gosh-web/repository/index.html | 1902 +++++++++++ .../gosh-web/task/index.html | 1746 ++++++++++ .../working-with-tokens-and-karma/index.html | 1785 ++++++++++ .../index.html | 800 ++++- 60 files changed, 48034 insertions(+), 5071 deletions(-) create mode 100644 docs/user-guide/architecture.md create mode 100644 docs/user-guide/git-open-source-hodler.md create mode 100644 docs/user-guide/instruments-and-utilities.md create mode 100644 docs/user-guide/motivation.md create mode 100644 docs/user-guide/objective.md create mode 100644 docs/working-with-gosh/gosh-web copy 3.md create mode 100644 docs/working-with-gosh/gosh-web/account.md create mode 100644 docs/working-with-gosh/gosh-web/create-dao.md create mode 100644 docs/working-with-gosh/gosh-web/dao-overview.md create mode 100644 docs/working-with-gosh/gosh-web/dao-set-up.md create mode 100644 docs/working-with-gosh/gosh-web/grh-config.md create mode 100644 docs/working-with-gosh/gosh-web/members.md create mode 100644 docs/working-with-gosh/gosh-web/proposals-and-voting-in-smv.md create mode 100644 docs/working-with-gosh/gosh-web/repository.md create mode 100644 docs/working-with-gosh/gosh-web/task.md create mode 100644 docs/working-with-gosh/gosh-web/working-with-tokens-and-karma.md create mode 100644 site/user-guide/architecture/index.html create mode 100644 site/user-guide/git-open-source-hodler/index.html create mode 100644 site/user-guide/instruments-and-utilities/index.html create mode 100644 site/user-guide/motivation/index.html create mode 100644 site/user-guide/objective/index.html create mode 100644 site/working-with-gosh/gosh-web copy 3/index.html create mode 100644 site/working-with-gosh/gosh-web/account/index.html create mode 100644 site/working-with-gosh/gosh-web/create-dao/index.html create mode 100644 site/working-with-gosh/gosh-web/dao-overview/index.html create mode 100644 site/working-with-gosh/gosh-web/dao-set-up/index.html create mode 100644 site/working-with-gosh/gosh-web/grh-config/index.html create mode 100644 site/working-with-gosh/gosh-web/members/index.html create mode 100644 site/working-with-gosh/gosh-web/proposals-and-voting-in-smv/index.html create mode 100644 site/working-with-gosh/gosh-web/repository/index.html create mode 100644 site/working-with-gosh/gosh-web/task/index.html create mode 100644 site/working-with-gosh/gosh-web/working-with-tokens-and-karma/index.html diff --git a/docs/hacks-and-grants/user-guide.md b/docs/hacks-and-grants/user-guide.md index e3c191f..73452e8 100644 --- a/docs/hacks-and-grants/user-guide.md +++ b/docs/hacks-and-grants/user-guide.md @@ -259,6 +259,9 @@ At the end of the **`Voting`** stage, the summing up will start, and the Hackath ### **Expert Tags** + + Expert Tags are created as evidence of the member's expertise and experience within this DAO. By creating and attaching Tags to DAO members, you can count on their skills and experience to help other members of the DAO. diff --git a/docs/user-guide/architecture.md b/docs/user-guide/architecture.md new file mode 100644 index 0000000..61ab3ac --- /dev/null +++ b/docs/user-guide/architecture.md @@ -0,0 +1,9 @@ + +1. Build a scalable multithreaded, multisharded content addressable blockchain +2. Implement Git using [smart contracts](../on-chain-architecture/gosh-smart-contracts.md) +3. Implement [DAO](../on-chain-architecture/organizations-gosh-dao-and-smv.md) on top of that Git to allow building consensus around the code +4. Formally verify the smart contracts +5. Represent all entities by hashes (container images, git commits, blоbs, pull requests etc.); +6. Allow anyone to add some metadata with signature to any entity; +7. Allow anyone to decide whose metadata to trust; +8. Build chain/tree of trust: dependencies can be organized using the same architecture, and containers built diff --git a/docs/user-guide/git-open-source-hodler.md b/docs/user-guide/git-open-source-hodler.md new file mode 100644 index 0000000..08432d3 --- /dev/null +++ b/docs/user-guide/git-open-source-hodler.md @@ -0,0 +1,4 @@ + +(Yes, it's [Hodler](https://en.wiktionary.org/wiki/hodl)). + +**GOSH** is a blockchain built around securing the software supply chain and capturing the immense value in open source projects. This is achieved through record-setting blockchain tech, distributed programming, and a decentralized architecture - integrated into the same familiar git, meaning there is no change to the workflow. diff --git a/docs/user-guide/instruments-and-utilities.md b/docs/user-guide/instruments-and-utilities.md new file mode 100644 index 0000000..06f725c --- /dev/null +++ b/docs/user-guide/instruments-and-utilities.md @@ -0,0 +1,7 @@ + +A variety of utility tools to assist with all the aspects of the solution are under active development. Explore the tools available now to get started with GOSH: + +* create and manage your on-chain repositories through [GOSH Web](../working-with-gosh/gosh-web.md) or directly in the [Docker Extension](../working-with-gosh/docker-extension.md) +* work with on-chain repository as if you use a regular git repository with [Git Remote Helper](../working-with-gosh/git-remote-helper.md) + + diff --git a/docs/user-guide/motivation.md b/docs/user-guide/motivation.md new file mode 100644 index 0000000..6ba5b3d --- /dev/null +++ b/docs/user-guide/motivation.md @@ -0,0 +1,2 @@ + +The Software Supply Chain is a high-impact area. Yet there exists a distinctive lack of secure, trustless, verifiable, and transparent delivery of source code/binaries to developers and users in all software fields. Storing your code on a git means it has an owner, a single point of control, which leads to security vulnerabilities. Currently there is no industrial solution available that is not centralized and thus not dependent on the decisions of a few actors. The main way in which GOSH solves this issue is through allowing developers to build consensus around their code, so the more code is written, the more secure it becomes. diff --git a/docs/user-guide/objective.md b/docs/user-guide/objective.md new file mode 100644 index 0000000..eb3623a --- /dev/null +++ b/docs/user-guide/objective.md @@ -0,0 +1,2 @@ + +To create a truly decentralized development environment so that open source repositories can be run, governed, and monetized collectively. All the while, mitigating security and transparency issues arising from a conventional software supply chain. diff --git a/docs/working-with-gosh/gosh-web copy 3.md b/docs/working-with-gosh/gosh-web copy 3.md new file mode 100644 index 0000000..3c8da1f --- /dev/null +++ b/docs/working-with-gosh/gosh-web copy 3.md @@ -0,0 +1,1587 @@ +# __GOSH Web__ + +[GOSH Web](https://app.gosh.sh/) is also a good way to get started with GOSH. + +It implements GOSH repository management as a simple web interface. + +You will be able to create your GOSH account and Decentralized Autonomous Organization (DAO), set up and manage repositories. Repositories stored in GOSH can then be interacted with like any regular remote repository, with a few small configurations to git, making decentralized code management easily available to anyone. + + + + + + + + + +## __Working with account__ + + + +### __Create account__ + + +To get started with GOSH, you need an active Github-account. + +Click **Create account with Github** to start registering on GOSH + +![](../images/gosh_web_Authorize_Gosh_01.jpg) + + +After click **Authorize gosh-sh** + +![](../images/gosh_web_Authorize_Gosh_02.jpg) + +!!! info + The special GOSH DAO Bot will help with registration in Gosh. + It will deploy your DAO and upload your selected repositories to GOSH. + +In the list of organizations received from Github, click on the organization + +![](../images/gosh_web_Authorize_Gosh_03.jpg) + +and select repositories for upload into Gosh. + +![](../images/gosh_web_Authorize_Gosh_04.jpg) + +Do this **for each** organization for which you want to upload repositories to Gosh. + +!!! danger + After registering on GOSH you will not be able to return to this step in this release. + + This will be available later + +!!! info + If you want other GOSH users to be able to find you by your email, give permission. + +Then click **Upload** + +![](../images/gosh_web_Authorize_Gosh_05.jpg) + +​If you are familiar with blockchain, you know what to do with a seed phrase. + +If you're new to blockchain, all you need to know, is that this is the key to your account and all your assets on GOSH. Your public key, which can identify you on the blockchain and the secret key you'll use to sign your actions can always be calculated from your seed phrase. + +To create the GOSH-account, the seed phrase will be generated for you. If you already have the GOSH-account, click **Clear** and enter your own one seed phrase. + +!!! info + Your seed phrase will be used to log into GOSH. + + +!!! danger + **Write your seed phrase down and store it somewhere safe, and never share it with anyone. Avoid storing it in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets.** + + +Once you have written down your seed phrase, click **Continue.** + +![](../images/gosh_web_Authorize_Gosh_06_seedF.jpg) + + +Then choose your username in GOSH. **This is your unique cryptographic identifier in Gosh. +** + +!!! Danger + **Please note that after creating your username it will be impossible to change it in the future.** + +if your username is already taken, please choose another one. + +!!! warning + The username must contain only Latin letters, numbers, hyphen, underscore character `( a...z, 0...9, -, _ )` + +And click **Create account**. + +![](../images/gosh_web_Authorize_Gosh_07_createAk.jpg) + +When entering the GOSH will ask you to set up a PIN code: + +!!! info + Set a new PIN code for each new session. + +![](../images/gosh_web_Authorize_Gosh_10_pin.jpg) + +And unlock with PIN code. + +!!! warning + If the name of the organization or repository already exists, you will receive the message. + Change the name, click **save changes** and confirm the action with a pin code. + +![](../images/gosh_web_Authorize_Gosh_11_error_rename.jpg) + + +The Organizations page will open after your account is created. + +![](../images/gosh_web_Authorize_Gosh_08_wellcom.jpg) + + +!!! info + __When the repositories are uploaded, a notification will be sent to your email.__ + +Follow the link in the letter. + +![](../images/docker_ext_create_acc_02_welcom_letter.jpg) + +Enter the saved seed phrase and click **Sign in**. + +![](../images/gosh_web_Authorize_Gosh_09_signIn.jpg) + +Also set up a PIN code and unlock with PIN code. + + +### __View Public Key__ + + +A user needs to know their public key, for example, when joining an organization. + +To view your public key go to the main page of your account and click [**Settings**](https://app.gosh.sh/a/settings). + +!!! danger + Avoid storing your private key and seed phrase in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets. + +![](../images/gosh_web_View_Public_Key_01.jpg) + + + +## __Working with DAO__ + + + +​Once created, your organization will appear in the organization list. Click on it to continue. + +![](../images/gosh_web_Create_ORG_03_list_orgs.jpg) + +The first mandatory member is the GOSH DAO Bot. It will synchronize repositories with github on Gosh. + +The second member is the creator, identified by their username. + +At any later time the list of members [can be expanded](gosh-web.md#add-members-to-dao) by voting. + + +### __Create Organization (DAO)__ + + + + +Click **Сreate new DAO** button in the Organizations section. + +![](../images/gosh_web_Create_ORG_01.jpg) + +On the DAO settings page that opens, input: + +* __Organization name__ + + !!! warning + The Organizations name must contain only Latin letters, numbers, hyphen, underscore character `( a...z, 0...9, -, _ )` + +* __Organization picture__ + + The icon will be generated automatically. + +* __Theme tags__ + + You can add up to 3 tags separated by spaces. + According to them, GOSH users will be able to find your DAO. + +* __Description__ + + A short description that can be seen on the DAO tab under the heading. + + The extended description can be added to the Readme file into _index system repository from the [Overview page](gosh-web.md#overview-of-the-dao) after creating the DAO. + +* __Total supply__ + + You also need to enter the number of tokens that will be issued for this DAO. + + The maximum value of the total supply can be the number 2^128. + +* __Allow mint__ + + This is a permission to emission DAO tokens. + It is enabled by default. + + In the future, it will be possible to disable the emission of DAO tokens through proposal and voting in the [**Settings**](gosh-web.md#dao-set-up) section. + + !!! warning + If you uncheck this option, the number of tokens issued for this DAO will be capped to the number entered during the initial setup + +Click **Create organization**. + +![](../images/gosh_web_Create_ORG_02_set_up_DAO.jpg) + +The DAO tab will open after its creation. + + +### __Overview of the DAO__ + + +All information about your DAO and its activities will be displayed here. + +![](../images/gosh_web_Create_ORG_04_DAO-page.jpg) + +Information about DAO assets is displayed on the right. + +* **DAO total supply** - the total issue of tokens of this DAO. + +* **DAO reserve** - unallocated tokens. + + Push on the **Send** button, you will create an proposal to transfer tokens from the DAO reserve to the DAO member. + + + Push on the **Mint** button, you will [create an proposal to mint additional tokens](gosh-web.md#additional-minting-of-tokens-for-dao) for this DAO. + +![](../images/gosh_web_OVERVIEW_01_total_suply.jpg) + + +* **Your wallet balance** - the amount of tokens you have in this DAO. + + !!! info + When creating a DAO, 20 tokens from the DAO reserve will be issued to your wallet. + + Push on the **SEND** button, you will to transfer your tokens to the DAO reserve or to the GOSH user. + + +* **Karma** - the amount of tokens (upper limit) within which a DAO member can vote. + + It is assigned when accepted as a member of the DAO. This determines the reputation of the DAO member. The Karma can be changed only by voting. + +![](../images/gosh_web_OVERVIEW_02_wallet_balance.jpg) + + +* **Members** - total number of DAO members. + + From here you can also send an invitation to become a member of the DAO. + + +![](../images/gosh_web_OVERVIEW_03_members.jpg) + + +* **Recent proposals** + +Information and status of the recent proposals will be displayed in this section. +Click on the name of the proposal you can go to the event page and [vote](gosh-web.md#proposals-and-voting-in-smv-soft-majority-vote). + +![](../images/gosh_web_OVERVIEW_05_recent_proposals.jpg) + + +* In the **Repositories** section, you can quickly find or [create a repository](gosh-web.md#create-repository). + +![](../images/gosh_web_OVERVIEW_06_repositories.jpg) + +* **DAO system repository** + +The **_index** is a DAO system repository that is created automatically. + +!!! info + After creating the DAO, it will already contain + a text file with a brief description of your DAO, + which you added in the settings earlier. + +To add a README for your DAO, go to the _index repository or follow the link in this section. + + + + +![](../images/gosh_web_OVERVIEW_04_readme_md.jpg) + +Make sure you are in the **main** branch and click **Add file** button. + +![](../images/gosh_web_Readme_md_01.jpg) + +Enter file contents and name. + +![](../images/gosh_web_Readme_md_02_content.jpg) + +You can use **Preview** if needed. MD syntax is supported for preview. + +After scroll down and enter commit info: + +* Commit description - you can add a description of your commit; + +* Commit tags - this is a mutable pointer of the commit. You can add the tag to quickly go to this commit and see what has been done; + + +![](../images/gosh_web_Readme_md_03_2_data_commit.jpg) + +* Select a task - if you want to attach your commit to the solution of the Task, then select the desired task from the list; + +![](../images/gosh_web_Task_11_select_tast.jpg) + +* and add Assigners, Reviewers and Managers if necessary. + +![](../images/gosh_web_Task_11_2_select_tast_participants.jpg) + +If a Task has been selected, check the **Create proposal** box. + +And click **Commit changes** + +![](../images/gosh_web_Readme_md_03_data_commit.jpg) + + + +After that a proposal to the pull request will be created. + +![](../images/gosh_web_Task_12_proposal_to_commit_with_task.jpg) + +When the proposal to the pull request is accepted, the description of the DAO will appear on the **Overview** tab. + +![](../images/gosh_web_Readme_md_05_owerviw.jpg) + +### __DAO Set up__ + + +You can continue with the initial setup the DAO in the Settings tab. + + +![](../images/gosh_web_Create_ORG_05_DAO_settings_01_all.jpg) + +In the **Token Setup** section, you can create a proposal to ban the issue of tokens from this DAO by unchecking the box. + +!!! warning + After the ban on the issue of DAO tokens, it will be impossible to allow the issue. + +![](../images/gosh_web_Create_ORG_05_DAO_settings_02_token_setup.jpg) + +In the **Proposal setup** section you can enable/disable the option to view the voting results before it ends. + +And also allow or prohibit discussion when working with proposals. + +![](../images/gosh_web_Create_ORG_05_DAO_settings_03_proposal_setup.jpg) + + +In the **Members setup** section you can grant or deny external users the ability to request membership in this DAO. + +![](../images/gosh_web_Create_ORG_05_DAO_settings_04_member_setup.jpg) + + +Then add a comment on changing the settings for other members of the DAO and click **Save changes and start proposal**. + +![](../images/gosh_web_Create_ORG_05_DAO_settings_05_save_changes.jpg) + +!!! info + __All settings and actions in the DAO will be performed the [voting](gosh-web.md#voting-in-smv-soft-majority-vote) procedure.__ + + +### __Upgrade__ + +#### __Basic information__ +When a new version of contracts is released in GOSH, the user needs to upgrade their contracts. + +The upgrade is initiated by the [proposal](gosh-web.md#proposals-and-voting-in-smv-soft-majority-vote). + +!!! warning + Make sure that the proposal for such an update has not yet been created. + +!!! info + Complete all proposle before starting the upgrade. All uncompleted proposals will be rejected and will not be transferred to the upgraded version. + +You can see a message about the availability of a new version +and an invitation to update in the DAO. + +Depending on which version you currently have, choose the appropriate update method. + +!!! warning "" + It is recommended to upgrade to the latest version. + +!!! info + All token holders after upgrading the DAO must transfer their tokens from previous versions. + + +#### __from v. 1 to v. 2__ + +You can switch to the **Upgrade** section from the new version message or go to the **Settings** tab. + +![](../images/gosh_web_upgrade_01_msg_v1tov2.jpg) + +Select the version you want to upgrade and click **Create proposal for DAO upgrade**: + +![](../images/gosh_web_upgrade_02_in_settings.jpg) + +You will be taken to the DAO tab with events. + +![](../images/gosh_web_upgrade_03_proposal.jpg) + +After accepting the proposal, the procedure for updating your DAO will begin. + +Then you need to update all the Repositories. + +To do this, go to their tab and click **Get repositories** + +![](../images/gosh_web_upgrade_04_1_get_repo.jpg) + +and then click **Start repositories upgrade** to create a proposal. + +![](../images/gosh_web_upgrade_04_2_upgr_repo.jpg) + +On the DAO tab, vote for the proposal to create a repository. + +![](../images/gosh_web_upgrade_04_3_proposal_upgr_repo.jpg) + +After the proposal is accepted, the contract version will be upgraded. + +![](../images/gosh_web_upgrade_04_4_DAO_v2.jpg) + +#### __from v. 2 to v. 3__ + +!!! info "**Release notes**" + + **Contracts** + + * Added possibility of a DAO to be a member of another DAO + + * Added possibility of DAO to be a Task performer. A DAO itself can now be a signer, reviewer, and manager of a Task in another DAO — Tasks now have the same functionality for DAOs as for individuals + + * Improve native token management in contracts. This is mainly bug fixes for the back-end blockchain tokens that guarantee the operations of a smart contract + + * Added possibility of task upgrade. Upgrades from Smart Contract version 2.0 to 3.0 required a redeployment of all Tasks. From now on all future upgrades will not affect previously created Tasks + + * Task rewards do not increase karma. From now on Tasks will only serve to remunerate contributors with DAO Tokens but without increasing their Voting Karma + + * Added a possibility to create index contracts. Version 3.0 now includes indexes that improve the performance of GOSH when used in a web browser + + **Interface** + + * DAOs can become members of other DAOs. DAOs have equal interface user flows for this operation + + * A DAO can be set as a Task assignee, reviewer, and manager (DAO review, receive task bounty is not implemented yet). Web browsers now also fully support Task functionality + + * DAO can create proposals and vote for proposals in parent DAO (not implemented yet) + + * ask rewards do not increase karma + + * If a DAO owns tokens of another DAOs “DAO supply” block will contain a button with details. The GOSH interface now has a block to allow DAO members to see which tokens the DAO holds + + **Git Remote Helper** + + * supports all functionality of Smart Contract Version 3.0 + + +The Tasks were added in contracts version 2. + +Uninitialized Tasks will not be migrated to the new version. You will need to create these tasks in the new version. + +!!! warning + Before starting the update make sure that there are commits in the Tasks. + +Go to the Settings tab or follow the link in the upgrade message. + +![](../images/gosh_web_upgrade_05_msg_v2tov3.jpg) + +Select the version you want to update and click **Create proposal for DAO upgrade** + +![](../images/gosh_web_upgrade_06_settings_v2tov3.jpg) + +You will be taken to the DAO tab with events. + +![](../images/gosh_web_upgrade_07_proposal_v2tov3.jpg) + +Inside the event, you can get acquainted with the details of the proposal. + +![](../images/gosh_web_upgrade_07_2_proposal_details_v2tov3.jpg) + +After accepting the proposals, the DAO update process will begin. +Before continuing, you need to transfer your tokens. + +To do this, go to the **Overview** tab in the **Your wallet balance** section and click **Transfer from previous version**. + +![](../images/gosh_web_upgrade_07_3_1_transfer_tokens.jpg) + +You can also do this on the **Members** tab. + +![](../images/gosh_web_upgrade_07_3_1_1_tokens_no_transf.jpg) + +Then you need to update the DAO repositories and tags. +To do this, click **upgrade** in the information message + +![](../images/gosh_web_upgrade_07_3_DAO_v3_msg_upgr_repo.jpg) + +and go to the repository uprade page. +Click **Get repositories**. + +![](../images/gosh_web_upgrade_07_5_page_upgr_repo.jpg) + +Then click **Start repositories upgrade** to create a proposal. + +![](../images/gosh_web_upgrade_07_6_start_upgr_repo.jpg) + +The process will be displayed below: + +![](../images/gosh_web_upgrade_07_7_process.jpg) + +As a result, you will be redirected to the DAO events page. + +![](../images/gosh_web_upgrade_07_8_event.jpg) + +The details of the Multi proposal can be found at the event. + +![](../images/gosh_web_upgrade_07_8_MP_details.jpg) + +Then click **tasks upgrade page** in the information message + +![](../images/gosh_web_upgrade_07_9_msg_upgr_task.jpg) + +and click **Start tasks upgrade** on the page that opens. + +![](../images/gosh_web_upgrade_07_10_page_upgr_tasks.jpg) + +![](../images/gosh_web_upgrade_07_11_process.jpg) + +You will be taken to the DAO tab with events. + +![](../images/gosh_web_upgrade_07_12_event.jpg) + +After accepting the proposal, the tasks will be transferred from the previous version and the contract upgrade to version 3 will be completed. + + + +#### __From v. 3 to v. 4/5/6.0/6.1__ + +Uninitialized Tasks will not be migrated to the new version. You will need to create these tasks in the new version. + +!!! warning + Before starting the update make sure that there are commits in the Tasks. + +Go to the Settings tab or follow the link in the upgrade message. + +![](../images/gosh_web_upgrade_08_01_msg_v3tov4.jpg) + +Select the version you want to update and click **Create proposal for DAO upgrade** + +![](../images/gosh_web_upgrade_08_02_settings_v3tov4.jpg) + +You will be taken to the DAO tab with events. + +![](../images/gosh_web_upgrade_08_03_proposal.jpg) + +Inside the event, you can get acquainted with the details of the proposal. + +![](../images/gosh_web_upgrade_08_04_event_datails.jpg) + +After accepting the proposals, the DAO update process will begin. +Before continuing, you need to transfer your tokens. + + +!!! info + Starting from the 5th version, tokens are transferred automatically. + +!!! warning + **If you have tokens that were locked into voting in previous versions of the DAO at the time of the upgrade, please note that these tokens will be transferred only after the expiration of the proposal.** + + + +If you have a DAO version lower than the 4th inclusive, then to transfer tokens go to the **Overview** tab in the **Your wallet balance** section and click **Transfer from previous version**. + +![](../images/gosh_web_upgrade_07_3_1_transfer_tokens.jpg) + +You can also do this on the **Members** tab. + +![](../images/gosh_web_upgrade_07_3_1_1_tokens_no_transf.jpg) + +Then you need to update the DAO repositories and tags. +To do this, click **upgrade** in the information message + +![](../images/gosh_web_upgrade_08_05_DAO_v3_msg_upgr_repo.jpg) + +and go to the repository uprade page. +Click **Get repositories**. + +![](../images/gosh_web_upgrade_07_5_page_upgr_repo.jpg) + +Then click **Start repositories upgrade** to create a proposal. + +![](../images/gosh_web_upgrade_07_6_start_upgr_repo.jpg) + +The process will be displayed below: + +![](../images/gosh_web_upgrade_07_7_process.jpg) + +As a result, you will be redirected to the DAO events page. + +![](../images/gosh_web_upgrade_07_8_event.jpg) + +The details of the Multi proposal can be found at the event. + +![](../images/gosh_web_upgrade_07_8_MP_details.jpg) + +Then click **tasks upgrade page** in the information message + +![](../images/gosh_web_upgrade_07_9_msg_upgr_task.jpg) + +and click **Start tasks upgrade** on the page that opens. + +![](../images/gosh_web_upgrade_07_10_page_upgr_tasks.jpg) + +![](../images/gosh_web_upgrade_07_11_process.jpg) + +You will be taken to the DAO tab with events. + +![](../images/gosh_web_upgrade_07_12_event.jpg) + +After accepting the proposal, the tasks will be transferred from the previous version and the contract upgrade to version 4 will be completed. + + + + + + + + +#### __From version 6.1 to 6.2__ + +!!! info "**Release notes for 6.2.0**" + + * [**Expert Tags**](gosh-web.md#expert-tags) have been introduced + + The list of decisions supported in this version includes: + + * [**Voting on Hackathon Results**](../hacks-and-grants/user-guide.md#expert-tags) + + * [**Creating a Repository with Expert Tags**](gosh-web.md#create-repository-with-expert-tags) + + * **The Upgrade System** has been improved + + * some bugs have been fixed + + +!!! warning + It's important to ensure that there are commits in the tasks and all proposals are completed before starting the update. + +Go to the Settings tab or follow the link in the upgrade message. + +![](../images/upgrade_DAO_6_2_0.jpg) + +Select the version you want to update and click **Create proposal for DAO upgrade** + +![](../images/upgrade_DAO_6_2_0_choice_version.jpg) + +You will be redirected to the page with the DAO event and will be able to vote for this proposal. + +After accepting the proposals, the DAO update process will begin. + +![](../images/upgrade_DAO_6_2_0_accepted_proposal_upgrd.jpg) + + +!!! warning + **If you have tokens that were locked into voting in previous versions of the DAO at the time of the upgrade, please note that these tokens will be transferred only after the expiration of the proposal.** + + + + + +You should reload the page to continue updating your DAO. + +![](../images/upgrade_DAO_6_2_0_reload.jpg) + + +Once you've done that, click on the **Complete upgrade** button in the message that appears + +![](../images/upgrade_DAO_6_2_0_complete_upgrade.jpg) + +Then, a new window will open up and you'll need to click on "Start upgrade complete process" to begin the data migration process between versions of DAOs. + +![](../images/upgrade_DAO_6_2_0_complete_upgrade_start.jpg) + +As a result, multiple proposals will be created to transfer all data from your DAO to the new version +(*migrating the Index repository and all Hackathons, upgrading the DAO repositories*) + +After all proposals are accepted, the DAO update process can be considered complete. + + +### __Proposals and voting in SMV (Soft Majority Vote)__ + + +Actions that require a DAO vote are performed by creating a proposal. + +!!! warning + To create an proposal, you must have at least 20 tokens on your wallet balance. + + +* [**Create a pull request**](gosh-web.md#create-pull-request) +* **Add branch protection** +* **Remove branch protection** +* [**Add DAO member**](gosh-web.md#add-members-to-dao) +* [**Remove DAO member**](gosh-web.md#delete-members-from-the-dao) +* [**Upgrade DAO**](gosh-web.md#upgrade) +* [**Delete task**](gosh-web.md#deleting-task) +* [**Create task**](gosh-web.md#create-task) +* [**Create repository**](gosh-web.md#create-repository) +* **Add voting tokens** +* **Add regular tokens** +* **Mint DAO tokens** + +* **Disable minting DAO tokens** +* **Change DAO member Karma** + + + + +* **Multi proposal** - includes several offers at once. + + For example: [adding members to the DAO by another DAO member](gosh-web.md#add-members-to-dao) + + + +* **Allow event discussions** +* **Show event progress** + +* [**Ask DAO membership allowance**](gosh-web.md#request-dao-membership) + + + +To vote for the proposal, some of your tokens must be be allocated to SMV (once the proposal is completed), you can get them back. + +!!! info + You can vote for a proposal only once. + +For example, to merge into main, [create a pull request](gosh-web.md#create-pull-request) from some other branch. A proposal will be generated and will appear on the **DAO** tab. + + + + + +Open the proposal and review the contents. + + + +The voting period is indicated on the proposal page. This is the time allotted for [voting](../on-chain-architecture/organizations-gosh-dao-and-smv.md#soft-majority-voting). + +Unless a decisive majority of >50% Global Karma Count is achieved early, votes will be counted at the end of this period. + +!!! info + Global Karma Count is the total amount of Karma calculated by summing up the Karma of all DAO members at the time of the proposal creation. + + + +Once you have made a decision, input the amount of tokens, select **Approve** or **Reject** and click **Vote for proposal**. Vote registration can take a bit of time. + +!!! info + As per the rules of Soft Majority Voting, to have a proposal approved early, you need at least 50% of the total supply of tokens in the repository + 1 token used to vote for the proposal. + + For example, in a repository with two members, where the total supply of tokens is 200, 101 token needs to be used to instantly approve a proposal. Thus with every member holding 100 tokens a proposal can never be instantly completed without the participation of members other than the proposal's author. + + On the other hand, so as not to depend on all members of an organization to vote, soft majority vote will complete with an approval at the end of the voting period, if 10% of the total token supply were used to vote for, and no one voted against. + + The more tokens are sent against the proposal, the higher the approving amount needs to be (up to 50% of the total supply + 1 token) for the proposal to pass. + +Other members of the Organization, who have transferred their tokens to SMV, will be able to vote for the proposal on this page in their own accounts. + +!!! info + Currently, even in organizations with a single member, voting still takes place when a proposal is created. 51 tokens are needed to approve a proposal in such a repository. + +Once a majority has been reached early, or the voting period ended and the soft majority vote result was decided, the proposal completes and the proposed action is performed. + + + +### __Working with tokens and Karma__ + + +#### Additional minting of tokens for DAO + +!!! warning + The option allowing the minting of DAO tokens must be enabled on the **Settings** tab in the **Token Settings section**. + +Click on the **Mint** button on the right on the **Overview** tab in the **DAO Reserve** section. +You will create an proposal to mint additional tokens for this DAO. + +In the window that appears, enter the amount of tokens to emission and add a description of the DAO members. Then click **Create proposal to mint tokens** + +![](../images/gosh_web_OVERVIEW_mint_01_create_proposal.jpg) + +After creating the proposal, you will be redirected to the **DAO** tab with events. + +![](../images/gosh_web_OVERVIEW_mint_02_event.jpg) + +Inside the event, you can get details of proposal. + +![](../images/gosh_web_OVERVIEW_mint_03_proposal_details.jpg) + +After the proposal is accepted, the changes will take effect. + +![](../images/gosh_web_OVERVIEW_mint_04_reserve.jpg) + +#### Additional voiting tokens and Karma + +Any member of the DAO can send a request to change Karma. +To do this, go to the **Members** tab and change the number of Karma and token balance of one or more DAO members, including for yourself. + +!!! warning + To create an proposal, you must have at least 20 tokens on your wallet balance. + +![](../images/gosh_web_memeber_change_karma_01_request.jpg) + +!!! Warning + Be careful when distributing karma among the members of the DAO. + Avoid the possibility of a preponderance in the votes of one of the DAO members. + To avoid a situation where one participant will be able to transfer the entire balance of the DAO to his wallet. + +Then click **Save changes and create proposal**. +As a result, a Multi proposal will be created and you will be redirected to the event tab **Dao**. + +![](../images/gosh_web_memeber_change_karma_02_event.jpg) + +Inside the event, you can get details of Multi proposal. + +![](../images/gosh_web_memeber_change_karma_03_detal_multi_proposal.jpg) + +After accepting the multi proposal, the user will receive tokens and Karma from DAO reserve. This can be seen on the **Members** tab. + +![](../images/gosh_web_memeber_change_karma_04_check_user_data.jpg) + + + +#### __Expert Tags__ + +You can now [add an Expert Tag](../hacks-and-grants/user-guide.md#expert-tags) to your DAO, which will grant additional Karma Voting Powers to each member possessing such Tags for decisions that support Expert Tags. + + + +#### Transfer of tokens from DAO reserve + +Tokens can be sent from the DAO reserve to + +* a member of this DAO; +* any GOSH user, who has visited this DAO at least once. + + +To do this, on the **Overview** tab in the **DAO reserve** section, click **Send**. + +![](../images/gosh_web_send_token_01_overview.jpg) + +In the window that opens, enter the name of the GOSH user or the name of the DAO and the amount of tokens to send. + +If you want the recipient's Karma to increase jointly with the token balance, then check this box. +Also write a description for the token transfer. This will help the DAO members to make a decision when voting. + +!!! Warning + Be careful when distributing karma among the members of the DAO. + Avoid the possibility of a preponderance in the votes of one of the DAO members. + To avoid a situation where one participant will be able to transfer the entire balance of the DAO to his wallet. + +Then click **Create proposal to send tokens** + +![](../images/gosh_web_send_token_02_window_send.jpg) + +After creating the offer, you will be redirected to the **DAO** page with events. + +![](../images/gosh_web_send_token_03_event.jpg) + +Inside the event, you can see detailed information about the proposal. + +![](../images/gosh_web_send_token_04_detaol_event.jpg) + +After the proposal is accepted, the tokens will be transferred to the balance wallet of the GOSH user or DAO. + +#### Transfer of tokens from user's wallet + +Tokens can be sent from the DAO reserve to + +* a member of this DAO; +* any GOSH user, who has visited this DAO at least once. + +!!! info + Only regular tokens are transferred. You will not be able to vote with such tokens. + +To send tokens from your wallet to the DAO, go to the **Overview** or **DAO** tab on the **Your wallet balance** section and click **Send**. + +![](../images/gosh_web_send_token_05_from_wallet_overview.jpg) + +In the window that opens, enter the name of the member of the DAO and the amount of tokens to send. +Then click **Send tokens** + +![](../images/gosh_web_send_token_06_window_send.jpg) + +After that, the tokens will be transferred to the recipient's wallet balance. + +![](../images/gosh_web_send_token_07_balans_resipient.jpg) + + + +## **Working with DAO Members** + + + +### __Adding Members to DAO__ + + +Membership in the DAO can be obtained in several ways. + +The user can be invited to the DAO using a [special form](gosh-web.md#add-by-gosh-username-or-e-mail) or by an [invitation link](gosh-web.md#invite-by-link). + +Also, the user can independently [create a membership request](gosh-web/#request-dao-membership) in the DAO. + +!!! info + Adding a member to the DAO is possible only through an proposal. + + +*Depending on the chosen path, tokens and Karma will be distributed immediately after acceptance proposal, or additional proposals will need to be created for this.* + + +#### Adding by GOSH username or e-mail + + +A DAO member can create a proposle to add GOSH user into the DAO. + +To do this, go to the tab **Members** in the section **Invite user to DAO**. + +* If you know the GOSH username, then enter it. + +* If you don't know the name or the user doesn't have a GOSH account yet, enter their email address. + + +!!! info + The email address will change to the GOSH username if the user has given permission during registration so that it can be found by email. + +Offer the amount of karma for him and please comment your decision. + +!!! info + You can send an invitation proposal to several users at once. + +And click **Send invite**. + +![](../images/gosh_web_Invite_to_DAO_01_1.jpg) + +!!! info + At the same time, a multi proposal will be created to add DAO members and provide voting tokens. + +Go to the DAO tab and select the desired event for voting. + + + +![](../images/gosh_web_Invite_to_DAO_by_form_voting.jpg) + +#### Invite by link + + +You can invite a user to the DAO by generating an invitation link for them. + +!!! warning + Enable "Allow external users to request DAO membership" option in [DAO settings](gosh-web.md#dao-set-up) to enable invites by email/link. + +To do this, on the tab **Members** in the section **Invite user to DAO** click on **Get one-time invitation link**. + +!!! info + The link to the invitation can only be used one time. + +![](../images/gosh_web_Invite_to_DAO_01_2.jpg) + + +All active invitation links will be displayed in the section on the right. + +When the invited user creates a membership proposle in the DAO, the link entry disappears. + +You can also deactivate the link click on the **Revoke**. + +![](../images/gosh_web_Invite_to_DAO_by_link_01_1_all_links.jpg) + + +When the user clicks the link, they will be able to create an account or log into GOSH. + +![](../images/gosh_web_Invite_to_DAO_by_link_02_create_akk.jpg) + + +Then input a short nickname or and click **Create account and continue**. + +![](../images/gosh_web_Invite_to_DAO_by_link_03_shot_nickname.jpg) + + +Enter a short comment who are you and click **Accept invitation**. + +![](../images/gosh_web_Invite_to_DAO_by_link_04_shot_comm_who_are_U.jpg) + + +On the event page that opens, you can find a request for your acceptance as a member of the DAO. + +Click on it you can track the results of voting and discussions. + +![](../images/gosh_web_Invite_to_DAO_by_link_05_Page_dao.jpg) + + +After the proposal is accepted, its status will change to **Accepted** + +![](../images/gosh_web_Invite_to_DAO_by_link_06_voitung_for_him_02.jpg) + + +!!! info + You will be able to request voting tokens after you are accepted into the DAO by creating your proposal. + + +#### Request DAO membership + +You can create a membership request in the DAO yourself. To do this, you need to know the link to this DAO. + +!!!info + Only a registered user will be able to create a membership request. + +Follow this link and you will see the overview tab of the DAO you are interested in. + +Click **Request membership**. + +![](../images/gosh_web_memeber_request_to_DAO_01.jpg) + +In the window that opens, write who you are and why you want to become a member of this DAO. This description will help the members of the DAO to make a decision when voting. + +Then click **Create proposal**. + +![](../images/gosh_web_memeber_request_to_DAO_02_input_description.jpg) + +On the event page that opens, you can find a request for your acceptance as a member of the DAO. + +![](../images/gosh_web_memeber_request_to_DAO_03_dao_events.jpg) + +After the DAO members vote, the status of your request will change to **Accepted** or **Rejected** + +You can follow the voting and discussion by opening the event. + + + + + + +### __Delete Members from the DAO__ + + +To delete a member from the DAO, go to the **Members** tab and click on the cross to the desired member. + +!!! warning + To create an proposal, you must have at least 20 tokens on your wallet balance. + +![](../images/gosh_web_memeber_delete_01.jpg) + +Confirm the deletion by clicking OK. + +![](../images/gosh_web_memeber_delete_02_confirm.jpg) + +As a result, a Multi proposal will be created and you will be redirected to the event tab **Dao**. + +![](../images/gosh_web_memeber_delete_03_event.jpg) + +The details of the multi proposl can be seen by going to it. + +![](../images/gosh_web_memeber_delete_04_event_detal.jpg) + +After voting and accepting multi proposal, the user will be deleted from the list of members of the DAO. + +![](../images/gosh_web_memeber_delete_05_list_without_user.jpg) + +The Karma of the deleted user will be equal to 0. +But the tokens, if they were, will stay on the balance of the user's wallet. + +![](../images/gosh_web_memeber_delete_06_balance_user.jpg) + + + +Then click **Save changes and create proposal**. +As a result, a Multi proposal will be created and you will be redirected to the event page **Dao**. + +![](../images/gosh_web_memeber_change_karma_02_event.jpg) + +Inside the event, you can get details of Multi proposal. + +![](../images/gosh_web_memeber_change_karma_03_detal_multi_proposal.jpg) + +After accepting the multi proposal, the user will receive tokens and Karma from DAO reserve. This can be seen on the **Members** tab + +![](../images/gosh_web_memeber_change_karma_04_check_user_data.jpg) + + + + +### __What's next?__ + + + +Set up [**Git Remote Helper**](git-remote-helper.md) and continue working with your repository. + +You'll need your wallet credentials. Go to the main page of your account and click [**User Settings**](https://app.gosh.sh/a/settings). + +Scroll down to the **Git remote config** section, click **Show** and unlock with PIN code + +![](../images/gosh_web_Whats_next_01.jpg) + +Download the configuration file by clicking on the icon +and save it to folder `~/.gosh` + +![](../images/gosh_web_Whats_next_01_config.jpg) + + +To view the command to clone your repo, click the **Clone** button on your repo page. + +![](../images/gosh_web_Whats_next_02.jpg) + + + +## __Working with Repository__ + + + +### __Create Repository__ + + +To create a repository in your DAO click **Create new** in the Repositories section or Overview section.​ + +![](../images/gosh_web_Create_Repo_01_new_repo.jpg) + +Enter repository name and its description and click **Create repository**. + +!!! warning + The repository name must contain only Latin letters, numbers,hyphen, underscore character`( a...z, 0...9, -, _ )` + +![](../images/gosh_web_Create_Repo_02_name_repo.jpg) + +A page with **DAO** events will open for you. + +![](../images/gosh_web_Create_Repo_03_event_create_repo.jpg) + +Open the event click on its name. + +![](../images/gosh_web_Event_02_all.jpg) + +The page that opens displays the name of the proposal, its status, and the time of creation and as well as the end of voting. + +![](../images/gosh_web_Event_03_status_time_details.jpg) + +The scale shows the number of votes for the proposal and against. + +![](../images/gosh_web_Event_04_result.jpg) + +Specify the number of tokens less than or equal to your Karma for voting and accept or reject this proposal. + +Add your opinion about the proposal to the discussion below and click **Send vote** + +![](../images/gosh_web_Event_05_vote.jpg) + +The created repository will appear in the list on the Repositories tab. + +![](../images/gosh_web_Create_Repo_04_repo_created.jpg) + + +#### __create repository with Expert Tags__ + +This will provide every Tag holder with increased Karma Powers when voting on commits, and for branch protection and unprotection. + + + +### __​Create Branch__ + + +Repository is created with default main branch. To create another branch, click on the **branches** counter.​ + +![](../images/gosh_web_Create_branch_01.jpg) + + +Select the branch to be forked, enter new branch name, and click​ **Create branch**. + +!!! warning + The branch name must contain only Latin letters, numbers, hyphen, underscore character `( a...z, 0...9, -, _ )` + +![](../images/gosh_web_Create_branch_02_name.jpg) + +Once the branch is created, it will appear in the branches list. + +![](../images/gosh_web_Create_branch_03_list_dranches.jpg) + +Switch to it via drop down list. + +![](../images/gosh_web_Create_branch_04_switch_branches.jpg) + + +### __Create File__ + + +To create file, click **Add file** button. + +![](../images/gosh_web_Create_file_01_new_file.jpg) + +Enter file contents and name. + +![](../images/gosh_web_Create_file_02_name_contents.jpg) + +You can use **Preview** if needed. MD syntax is supported for preview. + +After scroll down and enter commit info: + +* Commit description - you can add a description of your commit; + +* Commit tags - this is a mutable pointer of the commit. You can add the tag to quickly go to this commit and see what has been done; + +* Select task - if the branch is not protected and your file is a solution to a problem, you can choose a particular task; + +* and add Assigners, Reviewers and Managers if necessary. + + + and click **Commit changes** + +![](../images/gosh_web_Create_file_03_commit_data.jpg) + +If the branch you are working in requires no voting to confirm commits, the file will be added. Otherwise a DAO [vote](gosh-web.md#proposals-and-voting-in-smv-soft-majority-vote) will be initiated. + + + +Commit status will be displayed below. + +![](../images/gosh_web_Create_file_04_proces_create_file.jpg) + + +### __Create Pull Request__ + + +Click on the **Pull requests** tab and set up the pull request: what branch to merge from and to. Once selected, click **Compare**. + +![](../images/gosh_web_Create_PR_01.jpg) + +The branches will be compared. Review the changes, set up the pull request and click Commit changes. + +![](../images/gosh_web_Create_PR_02_comparing.jpg) + + +!!! info + **Note**: When merging into the main branch, and in some other cases (depending on DAO setup), a DAO proposal will be initiated by trying to commit. + + Organization Tokens have to be sent to the DAO Soft Majority Vote contract to start a proposal for DAO members to [vote](gosh-web.md#proposals-and-voting-in-smv-soft-majority-vote) on. + + +### __Add protection for a branch__ + + +If you want the changes to be added to the branch based on the voting results, then add protection to the branch. + +This can be done by creating an appropriate proposal. + +To do this, go from the **Repositories** tab to the repository you need. + +![](../images/gosh_web_Protect_branch_01_repos.jpg) + +Then, on the Branches tab, click the **Protect** button for the branch to which you want to add protection. + +![](../images/gosh_web_Protect_branch_02_branches.jpg) + +After creating the proposal, you will be redirected to the **DAO** page with events. + +![](../images/gosh_web_Protect_branch_03_events.jpg) + +Inside the event, you can get details of proposal. + +![](../images/gosh_web_Protect_branch_04_details_proposal.jpg) + +After the proposal is accepted the branch is marked as protected. +A commit can be made to it only by voting. + +![](../images/gosh_web_Protect_branch_05_branches_protect.jpg) + +### __Remove protection for a branch__ + +If the branch no longer needs protection, you can remove it by initiating appropriate proposals. + +To do this, go from the **Repositories** tab to the repository you need. + +![](../images/gosh_web_Protect_branch_01_repos.jpg) + +Then, on the Branches tab, click the **Unprotect** button for the branch to which you want to add protection. + +![](../images/gosh_web_Protect_branch_remove_01_branches.jpg) + +A vote will be created and you will be redirected to the **DAO** page with events. + +![](../images/gosh_web_Protect_branch_remove_02_event.jpg) + +Inside the event, you can get details of proposal. + +![](../images/gosh_web_Protect_branch_remove_03_details_proposal.jpg) + +After accepting the proposal, the protection mark will be removed from the branch. +Now everyone can upload changes to the branch without voting. + +![](../images/gosh_web_Protect_branch_remove_04_branch_unprotect.jpg) + + +### __Adding comments to file__ + +You can add a comment to any line in the file. + +!!! info + Comments are linked to a specific comment. + + +To do this, open the file and hover over a line or block of lines and click on the blue icon that appears on the left. + +In the window that opens, enter your comment and click on the blue circle with an arrow to send it. + +![](../images/gosh_web_Comments_01.jpg) + +The comment line will be marked with a red icon on the left. + +![](../images/gosh_web_Comments_02.jpg) + +A thread of comments and replies to them will open on the right. + +![](../images/gosh_web_Comments_03.jpg) + +The discussion can be resolved. To do this, click the appropriate button: + +![](../images/gosh_web_Comments_04_resolve.jpg) + +!!! info + The discussion can be resumed if a new comment has been added to it. + +Up to 3 discussions can be expanded in one line. +You can switch between them. + +![](../images/gosh_web_Comments_05_more_comments.jpg) + + +### __Adding comments to Pull Request__ + +You can also add comments to Pull Request. +To do this, go from the **DAO** events page to the **Pull Request** vote in the **Pull request diff** section. +you can leave comments on any line or block of lines in the same way as in [commenting on a file](gosh-web.md#adding-comments-to-file). + +![](../images/gosh_web_Comments_06_for_PR.jpg) + +## __Working with Task__ + + + +### __Create Task__ + + +To create a Task, go to the Tasks tab and click **Create Task** + +![](../images/gosh_web_Create_Task_01.jpg) + +Then you need to fill in the Task conditions. + +The result of the Task should be a pull request to include changes in the repository. + +Select the repository for which the Task is being created. + +![](../images/gosh_web_Task_02_fill_repo.jpg) + +Add the Task name. + +You can add 3 tags separated by spaces to quickly find the task. + +![](../images/gosh_web_Task_03_name_tags.jpg) + +Then you need to evaluate the Task. + +**Task cost** is the number of tokens that will be paid from the DAO reserve for its execution. + +!!! info + The members of the DAO agree between themselves how to evaluate the Tasks. + +After attaching a pull request to the Task, the tokens will be distributed between the author, reviewer and manager in the ratio you set. + +**Commit author** - the person who executes the Task. +**Reviewer** - the person who checks the correctness of the Task. +**Manager** - the person who manages the Task execution process. + +!!! info + The number of authors, areviewers and managers is set at your choice. + +![](../images/gosh_web_Task_04_cost_distrb.jpg) + +Select vesting and lock periods. + +**Lock (cliff)** - the period after which the reward payments will begin. +The countdown will start after accepting the proposal about completing the Task. +**Vesting** - rules for transferring the fixed part of the tokens to the disposal of the contractor. + +For example, lock - 12 months, vesting - 2 months. + +!!! warning + In order for the investment scheme to be correct, the smaller of the number of tokens allocated to the members of the task must be a multiple of the number of months of investment. + +![](../images/gosh_web_Task_05_lock_vesting.jpg) + +Add a comment the token distribution rules and click **Create task and start proposal** + +![](../images/gosh_web_Task_06_comment.jpg) + +After creating the proposal, you will be taken to the **DAO** tab with events. + +![](../images/gosh_web_Task_07_event.jpg) + +Inside the proposal you will be able to see all the conditions of the Task. +In the table you can see the period since which month and in what parts the payments will be made to the members of the Task. + + + +![](../images/gosh_web_Task_09_event_details.jpg) + +After accepting the proposal, the Task will appear in the list on the **Tasks** tab with the status *Awaiting commits*. + +!!! info + When creating a Task the tokens (Task cost) from the DAO-reserve are written off and reserved on the Task-contract. + +![](../images/gosh_web_Task_10_list_tasks.jpg) + +When the Author has completed the Task, he adds it to the commit. + +!!! info + If you need to make several commits to complete a Task,, create a separate branch. + +And do **Select task** when creating the proposal to the pull request. + +Select the Task performed(s), reviewer(s), manager(s) if they worked on the task. The allocated shares of those who were not specified will be returned to the DAO-reserve. + +![](../images/gosh_web_Readme_md_03_data_commit.jpg) + +After that a proposal to the pull request will be created. + +![](../images/gosh_web_Task_12_proposal_to_commit_with_task.jpg) + +Detailed information can be viewed by going to it on the DAO tab with events. + +![](../images/gosh_web_Task_13_detail_proposal.jpg) + +If the reviewer was specified during the commit, the event will wait for verification from them. + +![](../images/gosh_web_Task_14_event%20review.jpg) + +Then, after the reviewer send the solution, it will be possible to vote for the proposal. +When the pull request is accepted, the Task status will change to **Confirmed**. + +![](../images/gosh_web_Task_15_task_status_confirmed.jpg) + +After the lock period ends, the members of the Task can receive a reward. +To do this, go to the **Tasks** tab in the completed Task and click **Claim reward**. + +!!! note + If Lock period (cliff) has been set to zero, then you can click **Claim reward** immediately after accepting the pull request. + +![](../images/gosh_web_Task_16_claim_reward.jpg) + +Thus the tokens will begin to be transferred to the wallets of the members of the completed Task in accordance with the vesting scheme when the lock period ends. + + +### __Deletе Task__ + + +To delete a Task, go to it on the **Tasks** tab. +And click to **Delete task** + +![](../images/gosh_web_Task_delete_01.jpg) + +After creating a proposal about deleting a Task, you will be redirected to the event tab **Dao**. + +![](../images/gosh_web_Task_delete_02_event.jpg) + +When the proposal is accepted, the Task will be deleted. +The tokens allocated for this Task will be returned to the DAO reserve. + diff --git a/docs/working-with-gosh/gosh-web/account.md b/docs/working-with-gosh/gosh-web/account.md new file mode 100644 index 0000000..cda7651 --- /dev/null +++ b/docs/working-with-gosh/gosh-web/account.md @@ -0,0 +1,133 @@ + +[GOSH Web](https://app.gosh.sh/) implements GOSH repository management as a simple web interface. + +You will be able to create your GOSH Account and Decentralized Autonomous Organization (DAO), set up and manage repositories. Repositories stored in GOSH can then be interacted with like any regular remote repository, with a few small configurations to git, making decentralized code management easily available to anyone. + + +## __Create Account__ + + +### __with GitHub__ + +To get started with GOSH, you need an active Github-account. + +Click **Create Account with Github** to start registering on GOSH + +![](../../images/gosh_web_Authorize_Gosh_01.jpg) + + +After click **Authorize gosh-sh** + +![](../../images/gosh_web_Authorize_Gosh_02.jpg) + +!!! info + The special GOSH DAO Bot will help with registration in Gosh. + It will deploy your DAO and upload your selected repositories to GOSH. + +In the list of organizations received from Github, click on the organization + +![](../../images/gosh_web_Authorize_Gosh_03.jpg) + +and select repositories for upload into Gosh. + +![](../../images/gosh_web_Authorize_Gosh_04.jpg) + +Do this **for each** organization for which you want to upload repositories to Gosh. + +!!! danger + After registering on GOSH you will not be able to return to this step in this release. + + This will be available later + +!!! info + If you want other GOSH users to be able to find you by your email, give permission. + +Then click **Upload** + +![](../../images/gosh_web_Authorize_Gosh_05.jpg) + +​If you are familiar with blockchain, you know what to do with a seed phrase. + +If you're new to blockchain, all you need to know, is that this is the key to your Account and all your assets on GOSH. Your public key, which can identify you on the blockchain and the secret key you'll use to sign your actions can always be calculated from your seed phrase. + +To create the GOSH-Account, the seed phrase will be generated for you. If you already have the GOSH-Account, click **Clear** and enter your own one seed phrase. + +!!! info + Your seed phrase will be used to log into GOSH. + + +!!! danger + **Write your seed phrase down and store it somewhere safe, and never share it with anyone. Avoid storing it in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets.** + + +Once you have written down your seed phrase, click **Continue.** + +![](../../images/gosh_web_Authorize_Gosh_06_seedF.jpg) + + +Then choose your username in GOSH. **This is your unique cryptographic identifier in Gosh. +** + +!!! Danger + **Please note that after creating your username it will be impossible to change it in the future.** + +if your username is already taken, please choose another one. + +!!! warning + The username must contain only Latin letters, numbers, hyphen, underscore character `( a...z, 0...9, -, _ )` + +And click **Create account**. + +![](../../images/gosh_web_Authorize_Gosh_07_createAk.jpg) + +When entering the GOSH will ask you to set up a PIN code: + +!!! info + Set a new PIN code for each new session. + +![](../../images/gosh_web_Authorize_Gosh_10_pin.jpg) + +And unlock with PIN code. + +!!! warning + If the name of the organization or repository already exists, you will receive the message. + Change the name, click **save changes** and confirm the action with a pin code. + +![](../../images/gosh_web_Authorize_Gosh_11_error_rename.jpg) + + +The Organizations page will open after your Account is created. + +![](../../images/gosh_web_Authorize_Gosh_08_wellcom.jpg) + + +!!! info + __When the repositories are uploaded, a notification will be sent to your email.__ + +Follow the link in the letter. + +![](../../images/docker_ext_create_acc_02_welcom_letter.jpg) + +Enter the saved seed phrase and click **Sign in**. + +![](../../images/gosh_web_Authorize_Gosh_09_signIn.jpg) + +Also set up a PIN code and unlock with PIN code. + + +### __with Google__ + +### __with Linkedln__ + + +## __View Public Key__ + + +A user needs to know their public key, for example, when joining an organization. + +To view your public key go to the main page of your Account and click [**Settings**](https://app.gosh.sh/a/settings). + +!!! danger + Avoid storing your private key and seed phrase in plain text or screenshots, or any other non-secure way. If you lose it, you lose access to your assets. Anyone who gets it, gets full access to your assets. + +![](../../images/gosh_web_View_Public_Key_01.jpg) \ No newline at end of file diff --git a/docs/working-with-gosh/gosh-web/create-dao.md b/docs/working-with-gosh/gosh-web/create-dao.md new file mode 100644 index 0000000..92cf4cd --- /dev/null +++ b/docs/working-with-gosh/gosh-web/create-dao.md @@ -0,0 +1,53 @@ + +[**DAO - (Decentralized Autonomous Organization)**](../../on-chain-architecture/organizations-gosh-dao-and-smv.md#dao) is a tool that enables developers to build on GOSH in a way that is decentralized, secure, and scalable. + + + + +Click **Сreate new DAO** button in the Organizations section. + +![](../../images/gosh_web_Create_ORG_01.jpg) + +On the DAO settings page that opens, input: + +* __Organization name__ + + !!! warning + The Organizations name must contain only Latin letters, numbers, hyphen, underscore character `( a...z, 0...9, -, _ )` + +* __Organization picture__ + + The icon will be generated automatically. + +* __Theme tags__ + + You can add up to 3 tags separated by spaces. + According to them, GOSH users will be able to find your DAO. + +* __Description__ + + A short description that can be seen on the DAO tab under the heading. + + The extended description can be added to the Readme file into _index system repository from the [Overview page](../gosh-web.md#overview-of-the-dao) after creating the DAO. + +* __Total supply__ + + You also need to enter the number of tokens that will be issued for this DAO. + + The maximum value of the total supply can be the number 2^128. + +* __Allow mint__ + + This is a permission to emission DAO tokens. + It is enabled by default. + + In the future, it will be possible to disable the emission of DAO tokens through proposal and voting in the [**Settings**](../gosh-web.md#dao-set-up) section. + + !!! warning + If you uncheck this option, the number of tokens issued for this DAO will be capped to the number entered during the initial setup + +Click **Create organization**. + +![](../../images/gosh_web_Create_ORG_02_set_up_DAO.jpg) + +The DAO tab will open after its creation. diff --git a/docs/working-with-gosh/gosh-web/dao-overview.md b/docs/working-with-gosh/gosh-web/dao-overview.md new file mode 100644 index 0000000..fa976c3 --- /dev/null +++ b/docs/working-with-gosh/gosh-web/dao-overview.md @@ -0,0 +1,122 @@ + + + + +All information about your DAO and its activities will be displayed here. + +![](../../images/gosh_web_Create_ORG_04_DAO-page.jpg) + +Information about DAO assets is displayed on the right. + +### **DAO total supply** +the total issue of tokens of this DAO. + +### **DAO reserve** +unallocated tokens. + + Push on the **Send** button, you will create an proposal to transfer tokens from the DAO reserve to the DAO member. + + + Push on the **Mint** button, you will [create an proposal to mint additional tokens](../gosh-web.md#additional-minting-of-tokens-for-dao) for this DAO. + +![](../../images/gosh_web_OVERVIEW_01_total_suply.jpg) + + +### **Your wallet balance** +the amount of tokens you have in this DAO. + + !!! info + When creating a DAO, 20 tokens from the DAO reserve will be issued to your wallet. + + Push on the **SEND** button, you will to transfer your tokens to the DAO reserve or to the GOSH user. + + +### **Karma** +the amount of tokens (upper limit) within which a DAO member can vote. + + It is assigned when accepted as a member of the DAO. This determines the reputation of the DAO member. The Karma can be changed only by voting. + +![](../../images/gosh_web_OVERVIEW_02_wallet_balance.jpg) + + +### **Members** +total number of DAO members. + + From here you can also send an invitation to become a member of the DAO. + + +![](../../images/gosh_web_OVERVIEW_03_members.jpg) + + +### **Recent proposals** + +Information and status of the recent proposals will be displayed in this section. +Click on the name of the proposal you can go to the event page and [vote](../gosh-web.md#proposals-and-voting-in-smv-soft-majority-vote). + +![](../../images/gosh_web_OVERVIEW_05_recent_proposals.jpg) + + +### **Repositories** +In the **Repositories** section, you can quickly find or [create a repository](../gosh-web.md#create-repository). + +![](../../images/gosh_web_OVERVIEW_06_repositories.jpg) + +### **DAO system repository** + +The **_index** is a DAO system repository that is created automatically. + +!!! info + After creating the DAO, it will already contain + a text file with a brief description of your DAO, + which you added in the settings earlier. + +To add a README for your DAO, go to the _index repository or follow the link in this section. + + + + +![](../../images/gosh_web_OVERVIEW_04_readme_md.jpg) + +Make sure you are in the **main** branch and click **Add file** button. + +![](../../images/gosh_web_Readme_md_01.jpg) + +Enter file contents and name. + +![](../../images/gosh_web_Readme_md_02_content.jpg) + +You can use **Preview** if needed. MD syntax is supported for preview. + +After scroll down and enter commit info: + +* Commit description - you can add a description of your commit; + +* Commit tags - this is a mutable pointer of the commit. You can add the tag to quickly go to this commit and see what has been done; + + +![](../../images/gosh_web_Readme_md_03_2_data_commit.jpg) + +* Select a task - if you want to attach your commit to the solution of the Task, then select the desired task from the list; + +![](../../images/gosh_web_Task_11_select_tast.jpg) + +* and add Assigners, Reviewers and Managers if necessary. + +![](../../images/gosh_web_Task_11_2_select_tast_participants.jpg) + +If a Task has been selected, check the **Create proposal** box. + +And click **Commit changes** + +![](../../images/gosh_web_Readme_md_03_data_commit.jpg) + + + +After that a proposal to the pull request will be created. + +![](../../images/gosh_web_Task_12_proposal_to_commit_with_task.jpg) + +When the proposal to the pull request is accepted, the description of the DAO will appear on the **Overview** tab. + +![](../../images/gosh_web_Readme_md_05_owerviw.jpg) diff --git a/docs/working-with-gosh/gosh-web/dao-set-up.md b/docs/working-with-gosh/gosh-web/dao-set-up.md new file mode 100644 index 0000000..5c6d7b8 --- /dev/null +++ b/docs/working-with-gosh/gosh-web/dao-set-up.md @@ -0,0 +1,397 @@ + +### __DAO Set up__ + + +You can continue with the initial setup the DAO in the **Settings** tab. + + +![](../../images/gosh_web_Create_ORG_05_DAO_settings_01_all.jpg) + + +#### **Tags** + + + + + +#### **Token Setup** + + +In the **Token Setup** section, you can create a proposal to ban the issue of tokens from this DAO by unchecking the box. + +!!! warning + After the ban on the issue of DAO tokens, it will be impossible to allow the issue. + +![](../../images/gosh_web_Create_ORG_05_DAO_settings_02_token_setup.jpg) + + +#### **Event setup** + + +In the **Event setup** section you can enable/disable the option to view the voting results before it ends. + +And also allow or prohibit discussion when working with proposals. + +![](../../images/gosh_web_Create_ORG_05_DAO_settings_03_proposal_setup.jpg) + + +#### **Members setup** + + +In the **Members setup** section you can grant or deny external users the ability to request membership in this DAO. + +![](../../images/gosh_web_Create_ORG_05_DAO_settings_04_member_setup.jpg) + + +Then add a comment on changing the settings for other members of the DAO and click **Save changes and start proposal**. + +![](../../images/gosh_web_Create_ORG_05_DAO_settings_05_save_changes.jpg) + +!!! info + __All settings and actions in the DAO will be performed the [voting](../gosh-web.md#voting-in-smv-soft-majority-vote) procedure.__ + + +### __Karma tags__ + + + +### __notifications__ + + + +### __Upgrade__ + + +#### __Basic information__ +When a new version of contracts is released in GOSH, the user needs to upgrade their contracts. + +The upgrade is initiated by the [proposal](../gosh-web.md#proposals-and-voting-in-smv-soft-majority-vote). + +!!! warning + Make sure that the proposal for such an update has not yet been created. + +!!! info + Complete all proposal before starting the upgrade. All uncompleted proposals will be rejected and will not be transferred to the upgraded version. + +You can see a message about the availability of a new version +and an invitation to update in the DAO. + +Depending on which version you currently have, choose the appropriate update method. + +!!! warning "" + It is recommended to upgrade to the latest version. + +!!! info + All token holders after upgrading the DAO must transfer their tokens from previous versions. + + +#### __from v. 1 to v. 2__ + +You can switch to the **Upgrade** section from the new version message or go to the **Settings** tab. + +![](../../images/gosh_web_upgrade_01_msg_v1tov2.jpg) + +Select the version you want to upgrade and click **Create proposal for DAO upgrade**: + +![](../../images/gosh_web_upgrade_02_in_settings.jpg) + +You will be taken to the DAO tab with events. + +![](../../images/gosh_web_upgrade_03_proposal.jpg) + +After accepting the proposal, the procedure for updating your DAO will begin. + +Then you need to update all the Repositories. + +To do this, go to their tab and click **Get repositories** + +![](../../images/gosh_web_upgrade_04_1_get_repo.jpg) + +and then click **Start repositories upgrade** to create a proposal. + +![](../../images/gosh_web_upgrade_04_2_upgr_repo.jpg) + +On the DAO tab, vote for the proposal to create a repository. + +![](../../images/gosh_web_upgrade_04_3_proposal_upgr_repo.jpg) + +After the proposal is accepted, the contract version will be upgraded. + +![](../../images/gosh_web_upgrade_04_4_DAO_v2.jpg) + +#### __from v. 2 to v. 3__ + +!!! info "**Release notes**" + + **Contracts** + + * Added possibility of a DAO to be a member of another DAO + + * Added possibility of DAO to be a Task performer. A DAO itself can now be a signer, reviewer, and manager of a Task in another DAO — Tasks now have the same functionality for DAOs as for individuals + + * Improve native token management in contracts. This is mainly bug fixes for the back-end blockchain tokens that guarantee the operations of a smart contract + + * Added possibility of task upgrade. Upgrades from Smart Contract version 2.0 to 3.0 required a redeployment of all Tasks. From now on all future upgrades will not affect previously created Tasks + + * Task rewards do not increase karma. From now on Tasks will only serve to remunerate contributors with DAO Tokens but without increasing their Voting Karma + + * Added a possibility to create index contracts. Version 3.0 now includes indexes that improve the performance of GOSH when used in a web browser + + **Interface** + + * DAOs can become members of other DAOs. DAOs have equal interface user flows for this operation + + * A DAO can be set as a Task assignee, reviewer, and manager (DAO review, receive task bounty is not implemented yet). Web browsers now also fully support Task functionality + + * DAO can create proposals and vote for proposals in parent DAO (not implemented yet) + + * ask rewards do not increase karma + + * If a DAO owns tokens of another DAOs “DAO supply” block will contain a button with details. The GOSH interface now has a block to allow DAO members to see which tokens the DAO holds + + **Git Remote Helper** + + * supports all functionality of Smart Contract Version 3.0 + + +The Tasks were added in contracts version 2. + +Uninitialized Tasks will not be migrated to the new version. You will need to create these tasks in the new version. + +!!! warning + Before starting the update make sure that there are commits in the Tasks. + +Go to the Settings tab or follow the link in the upgrade message. + +![](../../images/gosh_web_upgrade_05_msg_v2tov3.jpg) + +Select the version you want to update and click **Create proposal for DAO upgrade** + +![](../../images/gosh_web_upgrade_06_settings_v2tov3.jpg) + +You will be taken to the DAO tab with events. + +![](../../images/gosh_web_upgrade_07_proposal_v2tov3.jpg) + +Inside the event, you can get acquainted with the details of the proposal. + +![](../../images/gosh_web_upgrade_07_2_proposal_details_v2tov3.jpg) + +After accepting the proposals, the DAO update process will begin. +Before continuing, you need to transfer your tokens. + +To do this, go to the **Overview** tab in the **Your wallet balance** section and click **Transfer from previous version**. + +![](../../images/gosh_web_upgrade_07_3_1_transfer_tokens.jpg) + +You can also do this on the **Members** tab. + +![](../../images/gosh_web_upgrade_07_3_1_1_tokens_no_transf.jpg) + +Then you need to update the DAO repositories and tags. +To do this, click **upgrade** in the information message + +![](../../images/gosh_web_upgrade_07_3_DAO_v3_msg_upgr_repo.jpg) + +and go to the repository uprade page. +Click **Get repositories**. + +![](../../images/gosh_web_upgrade_07_5_page_upgr_repo.jpg) + +Then click **Start repositories upgrade** to create a proposal. + +![](../../images/gosh_web_upgrade_07_6_start_upgr_repo.jpg) + +The process will be displayed below: + +![](../../images/gosh_web_upgrade_07_7_process.jpg) + +As a result, you will be redirected to the DAO events page. + +![](../../images/gosh_web_upgrade_07_8_event.jpg) + +The details of the Multi proposal can be found at the event. + +![](../../images/gosh_web_upgrade_07_8_MP_details.jpg) + +Then click **tasks upgrade page** in the information message + +![](../../images/gosh_web_upgrade_07_9_msg_upgr_task.jpg) + +and click **Start tasks upgrade** on the page that opens. + +![](../../images/gosh_web_upgrade_07_10_page_upgr_tasks.jpg) + +![](../../images/gosh_web_upgrade_07_11_process.jpg) + +You will be taken to the DAO tab with events. + +![](../../images/gosh_web_upgrade_07_12_event.jpg) + +After accepting the proposal, the tasks will be transferred from the previous version and the contract upgrade to version 3 will be completed. + + + +#### __From v. 3 to v. 4/5/6.0/6.1__ + +Uninitialized Tasks will not be migrated to the new version. You will need to create these tasks in the new version. + +!!! warning + Before starting the update make sure that there are commits in the Tasks. + +Go to the Settings tab or follow the link in the upgrade message. + +![](../../images/gosh_web_upgrade_08_01_msg_v3tov4.jpg) + +Select the version you want to update and click **Create proposal for DAO upgrade** + +![](../../images/gosh_web_upgrade_08_02_settings_v3tov4.jpg) + +You will be taken to the DAO tab with events. + +![](../../images/gosh_web_upgrade_08_03_proposal.jpg) + +Inside the event, you can get acquainted with the details of the proposal. + +![](../../images/gosh_web_upgrade_08_04_event_datails.jpg) + +After accepting the proposals, the DAO update process will begin. +Before continuing, you need to transfer your tokens. + + +!!! info + Starting from the 5th version, tokens are transferred automatically. + +!!! warning + **If you have tokens that were locked into voting in previous versions of the DAO at the time of the upgrade, please note that these tokens will be transferred only after the expiration of the proposal.** + + + +If you have a DAO version lower than the 4th inclusive, then to transfer tokens go to the **Overview** tab in the **Your wallet balance** section and click **Transfer from previous version**. + +![](../../images/gosh_web_upgrade_07_3_1_transfer_tokens.jpg) + +You can also do this on the **Members** tab. + +![](../../images/gosh_web_upgrade_07_3_1_1_tokens_no_transf.jpg) + +Then you need to update the DAO repositories and tags. +To do this, click **upgrade** in the information message + +![](../../images/gosh_web_upgrade_08_05_DAO_v3_msg_upgr_repo.jpg) + +and go to the repository uprade page. +Click **Get repositories**. + +![](../../images/gosh_web_upgrade_07_5_page_upgr_repo.jpg) + +Then click **Start repositories upgrade** to create a proposal. + +![](../../images/gosh_web_upgrade_07_6_start_upgr_repo.jpg) + +The process will be displayed below: + +![](../../images/gosh_web_upgrade_07_7_process.jpg) + +As a result, you will be redirected to the DAO events page. + +![](../../images/gosh_web_upgrade_07_8_event.jpg) + +The details of the Multi proposal can be found at the event. + +![](../../images/gosh_web_upgrade_07_8_MP_details.jpg) + +Then click **tasks upgrade page** in the information message + +![](../../images/gosh_web_upgrade_07_9_msg_upgr_task.jpg) + +and click **Start tasks upgrade** on the page that opens. + +![](../../images/gosh_web_upgrade_07_10_page_upgr_tasks.jpg) + +![](../../images/gosh_web_upgrade_07_11_process.jpg) + +You will be taken to the DAO tab with events. + +![](../../images/gosh_web_upgrade_07_12_event.jpg) + +After accepting the proposal, the tasks will be transferred from the previous version and the contract upgrade to version 4 will be completed. + + + + + + + + +#### __From version 6.1 to 6.2__ + +!!! info "**Release notes for 6.2.0**" + + * [**Expert Tags**](../gosh-web.md#expert-tags) have been introduced + + The list of decisions supported in this version includes: + + * [**Voting on Hackathon Results**](../../hacks-and-grants/user-guide.md#expert-tags) + + * [**Creating a Repository with Expert Tags**](../gosh-web.md#create-repository-with-expert-tags) + + * **The Upgrade System** has been improved + + * some bugs have been fixed + + +!!! warning + It's important to ensure that there are commits in the tasks and all proposals are completed before starting the update. + +Go to the Settings tab or follow the link in the upgrade message. + +![](../../images/upgrade_DAO_6_2_0.jpg) + +Select the version you want to update and click **Create proposal for DAO upgrade** + +![](../../images/upgrade_DAO_6_2_0_choice_version.jpg) + +You will be redirected to the page with the DAO event and will be able to vote for this proposal. + +After accepting the proposals, the DAO update process will begin. + +![](../../images/upgrade_DAO_6_2_0_accepted_proposal_upgrd.jpg) + + +!!! warning + **If you have tokens that were locked into voting in previous versions of the DAO at the time of the upgrade, please note that these tokens will be transferred only after the expiration of the proposal.** + + + + + +You should reload the page to continue updating your DAO. + +![](../../images/upgrade_DAO_6_2_0_reload.jpg) + + +Once you've done that, click on the **Complete upgrade** button in the message that appears + +![](../../images/upgrade_DAO_6_2_0_complete_upgrade.jpg) + +Then, a new window will open up and you'll need to click on "Start upgrade complete process" to begin the data migration process between versions of DAOs. + +![](../../images/upgrade_DAO_6_2_0_complete_upgrade_start.jpg) + +As a result, multiple proposals will be created to transfer all data from your DAO to the new version +(*migrating the Index repository and all Hackathons, upgrading the DAO repositories*) + +After all proposals are accepted, the DAO update process can be considered complete. + + diff --git a/docs/working-with-gosh/gosh-web/grh-config.md b/docs/working-with-gosh/gosh-web/grh-config.md new file mode 100644 index 0000000..b7cc500 --- /dev/null +++ b/docs/working-with-gosh/gosh-web/grh-config.md @@ -0,0 +1,23 @@ + + + + +Set up [**Git Remote Helper**](../git-remote-helper.md) and continue working with your repository. + +You'll need your wallet credentials. Go to the main page of your account and click [**User Settings**](https://app.gosh.sh/a/settings). + +Scroll down to the **Git remote config** section, click **Show** and unlock with PIN code + +![](../../images/gosh_web_Whats_next_01.jpg) + +Download the configuration file by clicking on the icon +and save it to folder `~/.gosh` + +![](../../images/gosh_web_Whats_next_01_config.jpg) + + +To view the command to clone your repo, click the **Clone** button on your repo page. + +![](../../images/gosh_web_Whats_next_02.jpg) + diff --git a/docs/working-with-gosh/gosh-web/members.md b/docs/working-with-gosh/gosh-web/members.md new file mode 100644 index 0000000..6859fa8 --- /dev/null +++ b/docs/working-with-gosh/gosh-web/members.md @@ -0,0 +1,191 @@ +## **Working with DAO Members** + + + +### __Adding Members to DAO__ + + +Membership in the DAO can be obtained in several ways. + +The user can be invited to the DAO using a [special form](../gosh-web.md#add-by-gosh-username-or-e-mail) or by an [invitation link](../gosh-web.md#invite-by-link). + +Also, the user can independently [create a membership request](../gosh-web/#request-dao-membership) in the DAO. + +!!! info + Adding a member to the DAO is possible only through an proposal. + + +*Depending on the chosen path, tokens and Karma will be distributed immediately after acceptance proposal, or additional proposals will need to be created for this.* + + +#### Adding by GOSH username or e-mail + + +A DAO member can create a proposle to add GOSH user into the DAO. + +To do this, go to the tab **Members** in the section **Invite user to DAO**. + +* If you know the GOSH username, then enter it. + +* If you don't know the name or the user doesn't have a GOSH account yet, enter their email address. + + +!!! info + The email address will change to the GOSH username if the user has given permission during registration so that it can be found by email. + +Offer the amount of karma for him and please comment your decision. + +!!! info + You can send an invitation proposal to several users at once. + +And click **Send invite**. + +![](../../images/gosh_web_Invite_to_DAO_01_1.jpg) + +!!! info + At the same time, a multi proposal will be created to add DAO members and provide voting tokens. + +Go to the DAO tab and select the desired event for voting. + + + +![](../../images/gosh_web_Invite_to_DAO_by_form_voting.jpg) + +#### Invite by link + + +You can invite a user to the DAO by generating an invitation link for them. + +!!! warning + Enable "Allow external users to request DAO membership" option in [DAO settings](../gosh-web.md#dao-set-up) to enable invites by email/link. + +To do this, on the tab **Members** in the section **Invite user to DAO** click on **Get one-time invitation link**. + +!!! info + The link to the invitation can only be used one time. + +![](../../images/gosh_web_Invite_to_DAO_01_2.jpg) + + +All active invitation links will be displayed in the section on the right. + +When the invited user creates a membership proposle in the DAO, the link entry disappears. + +You can also deactivate the link click on the **Revoke**. + +![](../../images/gosh_web_Invite_to_DAO_by_link_01_1_all_links.jpg) + + +When the user clicks the link, they will be able to create an account or log into GOSH. + +![](../../images/gosh_web_Invite_to_DAO_by_link_02_create_akk.jpg) + + +Then input a short nickname or and click **Create account and continue**. + +![](../../images/gosh_web_Invite_to_DAO_by_link_03_shot_nickname.jpg) + + +Enter a short comment who are you and click **Accept invitation**. + +![](../../images/gosh_web_Invite_to_DAO_by_link_04_shot_comm_who_are_U.jpg) + + +On the event page that opens, you can find a request for your acceptance as a member of the DAO. + +Click on it you can track the results of voting and discussions. + +![](../../images/gosh_web_Invite_to_DAO_by_link_05_Page_dao.jpg) + + +After the proposal is accepted, its status will change to **Accepted** + +![](../../images/gosh_web_Invite_to_DAO_by_link_06_voitung_for_him_02.jpg) + + +!!! info + You will be able to request voting tokens after you are accepted into the DAO by creating your proposal. + + +#### Request DAO membership + +You can create a membership request in the DAO yourself. To do this, you need to know the link to this DAO. + +!!!info + Only a registered user will be able to create a membership request. + +Follow this link and you will see the overview tab of the DAO you are interested in. + +Click **Request membership**. + +![](../../images/gosh_web_memeber_request_to_DAO_01.jpg) + +In the window that opens, write who you are and why you want to become a member of this DAO. This description will help the members of the DAO to make a decision when voting. + +Then click **Create proposal**. + +![](../../images/gosh_web_memeber_request_to_DAO_02_input_description.jpg) + +On the event page that opens, you can find a request for your acceptance as a member of the DAO. + +![](../../images/gosh_web_memeber_request_to_DAO_03_dao_events.jpg) + +After the DAO members vote, the status of your request will change to **Accepted** or **Rejected** + +You can follow the voting and discussion by opening the event. + + + + + + +### __Delete Members from the DAO__ + + +To delete a member from the DAO, go to the **Members** tab and click on the cross to the desired member. + +!!! warning + To create an proposal, you must have at least 20 tokens on your wallet balance. + +![](../../images/gosh_web_memeber_delete_01.jpg) + +Confirm the deletion by clicking OK. + +![](../../images/gosh_web_memeber_delete_02_confirm.jpg) + +As a result, a Multi proposal will be created and you will be redirected to the event tab **Dao**. + +![](../../images/gosh_web_memeber_delete_03_event.jpg) + +The details of the multi proposl can be seen by going to it. + +![](../../images/gosh_web_memeber_delete_04_event_detal.jpg) + +After voting and accepting multi proposal, the user will be deleted from the list of members of the DAO. + +![](../../images/gosh_web_memeber_delete_05_list_without_user.jpg) + +The Karma of the deleted user will be equal to 0. +But the tokens, if they were, will stay on the balance of the user's wallet. + +![](../../images/gosh_web_memeber_delete_06_balance_user.jpg) + + + +Then click **Save changes and create proposal**. +As a result, a Multi proposal will be created and you will be redirected to the event page **Dao**. + +![](../../images/gosh_web_memeber_change_karma_02_event.jpg) + +Inside the event, you can get details of Multi proposal. + +![](../../images/gosh_web_memeber_change_karma_03_detal_multi_proposal.jpg) + +After accepting the multi proposal, the user will receive tokens and Karma from DAO reserve. This can be seen on the **Members** tab + +![](../../images/gosh_web_memeber_change_karma_04_check_user_data.jpg) + diff --git a/docs/working-with-gosh/gosh-web/proposals-and-voting-in-smv.md b/docs/working-with-gosh/gosh-web/proposals-and-voting-in-smv.md new file mode 100644 index 0000000..f4c5858 --- /dev/null +++ b/docs/working-with-gosh/gosh-web/proposals-and-voting-in-smv.md @@ -0,0 +1,145 @@ + +### __Proposals and voting in SMV (Soft Majority Vote)__ + +The main mechanism of interaction in the DAO is voting. Any action in a DAO requires a vote and is created through Proposals, and a [**soft-majority vote (SMV)**](../../on-chain-architecture/organizations-gosh-dao-and-smv.md#soft-majority-voting) of all other DAO members may be required to approve it. + + + + + +!!! warning + To create an proposal, you must have at least 20 tokens on your wallet balance. + +### __Types of Proposals:__ + +* [**Create a pull request**](../gosh-web.md#create-pull-request) +* **Add branch protection** +* **Remove branch protection** +* [**Add DAO member**](../gosh-web.md#add-members-to-dao) +* [**Remove DAO member**](../gosh-web.md#delete-members-from-the-dao) +* [**Upgrade DAO**](../gosh-web.md#upgrade) +* [**Delete task**](../gosh-web.md#deleting-task) +* [**Create task**](../gosh-web.md#create-task) +* [**Create repository**](../gosh-web.md#create-repository) +* **Add voting tokens** +* **Add regular tokens** +* **Mint DAO tokens** + +* **Disable minting DAO tokens** +* **Change DAO member Karma** + + + + +* **Multi proposal** - includes several offers at once. + + For example: [adding members to the DAO by another DAO member](../gosh-web.md#add-members-to-dao) + + + +* **Allow event discussions** +* **Show event progress** + +* [**Ask DAO membership allowance**](../gosh-web.md#request-dao-membership) + + + +To vote for the proposal, some of your tokens must be be allocated to SMV (once the proposal is completed), you can get them back. + +!!! info + You can vote for a proposal only once. + +For example, to merge into main, [create a pull request](../gosh-web.md#create-pull-request) from some other branch. A proposal will be generated and will appear on the **DAO** tab. + + + + + +Open the proposal and review the contents. + + + +The voting period is indicated on the proposal page. This is the time allotted for [voting](../../on-chain-architecture/organizations-gosh-dao-and-smv.md#soft-majority-voting). + +Unless a decisive majority of >50% Global Karma Count is achieved early, votes will be counted at the end of this period. + +!!! info + Global Karma Count is the total amount of Karma calculated by summing up the Karma of all DAO members at the time of the proposal creation. + + + +Once you have made a decision, input the amount of tokens, select **Approve** or **Reject** and click **Vote for proposal**. Vote registration can take a bit of time. + +!!! info + As per the rules of Soft Majority Voting, to have a proposal approved early, you need at least 50% of the total supply of tokens in the repository + 1 token used to vote for the proposal. + + For example, in a repository with two members, where the total supply of tokens is 200, 101 token needs to be used to instantly approve a proposal. Thus with every member holding 100 tokens a proposal can never be instantly completed without the participation of members other than the proposal's author. + + On the other hand, so as not to depend on all members of an organization to vote, soft majority vote will complete with an approval at the end of the voting period, if 10% of the total token supply were used to vote for, and no one voted against. + + The more tokens are sent against the proposal, the higher the approving amount needs to be (up to 50% of the total supply + 1 token) for the proposal to pass. + +Other members of the Organization, who have transferred their tokens to SMV, will be able to vote for the proposal on this page in their own accounts. + +!!! info + Currently, even in organizations with a single member, voting still takes place when a proposal is created. 51 tokens are needed to approve a proposal in such a repository. + +Once a majority has been reached early, or the voting period ended and the soft majority vote result was decided, the proposal completes and the proposed action is performed. + + diff --git a/docs/working-with-gosh/gosh-web/repository.md b/docs/working-with-gosh/gosh-web/repository.md new file mode 100644 index 0000000..787d5c7 --- /dev/null +++ b/docs/working-with-gosh/gosh-web/repository.md @@ -0,0 +1,229 @@ + + + + + + +### __Create Repository__ + + +To create a repository in your DAO click **Create new** in the Repositories section or Overview section.​ + +![](../../images/gosh_web_Create_Repo_01_new_repo.jpg) + +Enter repository name and its description and click **Create repository**. + +!!! warning + The repository name must contain only Latin letters, numbers,hyphen, underscore character`( a...z, 0...9, -, _ )` + +![](../../images/gosh_web_Create_Repo_02_name_repo.jpg) + +A page with **DAO** events will open for you. + +![](../../images/gosh_web_Create_Repo_03_event_create_repo.jpg) + +Open the event click on its name. + +![](../../images/gosh_web_Event_02_all.jpg) + +The page that opens displays the name of the proposal, its status, and the time of creation and as well as the end of voting. + +![](../../images/gosh_web_Event_03_status_time_details.jpg) + +The scale shows the number of votes for the proposal and against. + +![](../../images/gosh_web_Event_04_result.jpg) + +Specify the number of tokens less than or equal to your Karma for voting and accept or reject this proposal. + +Add your opinion about the proposal to the discussion below and click **Send vote** + +![](../../images/gosh_web_Event_05_vote.jpg) + +The created repository will appear in the list on the Repositories tab. + +![](../../images/gosh_web_Create_Repo_04_repo_created.jpg) + + +#### __create repository with Expert Tags__ + +This will provide every Tag holder with increased Karma Powers when voting on commits, and for branch protection and unprotection. + + + +### __​Create Branch__ + + +Repository is created with default main branch. To create another branch, click on the **branches** counter.​ + +![](../../images/gosh_web_Create_branch_01.jpg) + + +Select the branch to be forked, enter new branch name, and click​ **Create branch**. + +!!! warning + The branch name must contain only Latin letters, numbers, hyphen, underscore character `( a...z, 0...9, -, _ )` + +![](../../images/gosh_web_Create_branch_02_name.jpg) + +Once the branch is created, it will appear in the branches list. + +![](../../images/gosh_web_Create_branch_03_list_dranches.jpg) + +Switch to it via drop down list. + +![](../../images/gosh_web_Create_branch_04_switch_branches.jpg) + + +### __Create File__ + + +To create file, click **Add file** button. + +![](../../images/gosh_web_Create_file_01_new_file.jpg) + +Enter file contents and name. + +![](../../images/gosh_web_Create_file_02_name_contents.jpg) + +You can use **Preview** if needed. MD syntax is supported for preview. + +After scroll down and enter commit info: + +* Commit description - you can add a description of your commit; + +* Commit tags - this is a mutable pointer of the commit. You can add the tag to quickly go to this commit and see what has been done; + +* Select task - if the branch is not protected and your file is a solution to a problem, you can choose a particular task; + +* and add Assigners, Reviewers and Managers if necessary. + + + and click **Commit changes** + +![](../../images/gosh_web_Create_file_03_commit_data.jpg) + +If the branch you are working in requires no voting to confirm commits, the file will be added. Otherwise a DAO [vote](../gosh-web.md#proposals-and-voting-in-smv-soft-majority-vote) will be initiated. + + + +Commit status will be displayed below. + +![](../../images/gosh_web_Create_file_04_proces_create_file.jpg) + + +### __Create Pull Request__ + + +Click on the **Pull requests** tab and set up the pull request: what branch to merge from and to. Once selected, click **Compare**. + +![](../../images/gosh_web_Create_PR_01.jpg) + +The branches will be compared. Review the changes, set up the pull request and click Commit changes. + +![](../../images/gosh_web_Create_PR_02_comparing.jpg) + + +!!! info + **Note**: When merging into the main branch, and in some other cases (depending on DAO setup), a DAO proposal will be initiated by trying to commit. + + Organization Tokens have to be sent to the DAO Soft Majority Vote contract to start a proposal for DAO members to [vote](../gosh-web.md#proposals-and-voting-in-smv-soft-majority-vote) on. + + +### __Add protection for a branch__ + + +If you want the changes to be added to the branch based on the voting results, then add protection to the branch. + +This can be done by creating an appropriate proposal. + +To do this, go from the **Repositories** tab to the repository you need. + +![](../../images/gosh_web_Protect_branch_01_repos.jpg) + +Then, on the Branches tab, click the **Protect** button for the branch to which you want to add protection. + +![](../../images/gosh_web_Protect_branch_02_branches.jpg) + +After creating the proposal, you will be redirected to the **DAO** page with events. + +![](../../images/gosh_web_Protect_branch_03_events.jpg) + +Inside the event, you can get details of proposal. + +![](../../images/gosh_web_Protect_branch_04_details_proposal.jpg) + +After the proposal is accepted the branch is marked as protected. +A commit can be made to it only by voting. + +![](../../images/gosh_web_Protect_branch_05_branches_protect.jpg) + +### __Remove protection for a branch__ + +If the branch no longer needs protection, you can remove it by initiating appropriate proposals. + +To do this, go from the **Repositories** tab to the repository you need. + +![](../../images/gosh_web_Protect_branch_01_repos.jpg) + +Then, on the Branches tab, click the **Unprotect** button for the branch to which you want to add protection. + +![](../../images/gosh_web_Protect_branch_remove_01_branches.jpg) + +A vote will be created and you will be redirected to the **DAO** page with events. + +![](../../images/gosh_web_Protect_branch_remove_02_event.jpg) + +Inside the event, you can get details of proposal. + +![](../../images/gosh_web_Protect_branch_remove_03_details_proposal.jpg) + +After accepting the proposal, the protection mark will be removed from the branch. +Now everyone can upload changes to the branch without voting. + +![](../../images/gosh_web_Protect_branch_remove_04_branch_unprotect.jpg) + + +### __Adding comments to file__ + +You can add a comment to any line in the file. + +!!! info + Comments are linked to a specific comment. + + +To do this, open the file and hover over a line or block of lines and click on the blue icon that appears on the left. + +In the window that opens, enter your comment and click on the blue circle with an arrow to send it. + +![](../../images/gosh_web_Comments_01.jpg) + +The comment line will be marked with a red icon on the left. + +![](../../images/gosh_web_Comments_02.jpg) + +A thread of comments and replies to them will open on the right. + +![](../../images/gosh_web_Comments_03.jpg) + +The discussion can be resolved. To do this, click the appropriate button: + +![](../../images/gosh_web_Comments_04_resolve.jpg) + +!!! info + The discussion can be resumed if a new comment has been added to it. + +Up to 3 discussions can be expanded in one line. +You can switch between them. + +![](../../images/gosh_web_Comments_05_more_comments.jpg) + + +### __Adding comments to Pull Request__ + +You can also add comments to Pull Request. +To do this, go from the **DAO** events page to the **Pull Request** vote in the **Pull request diff** section. +you can leave comments on any line or block of lines in the same way as in [commenting on a file](../gosh-web.md#adding-comments-to-file). + +![](../../images/gosh_web_Comments_06_for_PR.jpg) diff --git a/docs/working-with-gosh/gosh-web/task.md b/docs/working-with-gosh/gosh-web/task.md new file mode 100644 index 0000000..5f4e3ca --- /dev/null +++ b/docs/working-with-gosh/gosh-web/task.md @@ -0,0 +1,133 @@ + + + + +### __Create Task__ + + +To create a Task, go to the Tasks tab and click **Create Task** + +![](../../images/gosh_web_Create_Task_01.jpg) + +Then you need to fill in the Task conditions. + +The result of the Task should be a pull request to include changes in the repository. + +Select the repository for which the Task is being created. + +![](../../images/gosh_web_Task_02_fill_repo.jpg) + +Add the Task name. + +You can add 3 tags separated by spaces to quickly find the task. + +![](../../images/gosh_web_Task_03_name_tags.jpg) + +Then you need to evaluate the Task. + +**Task cost** is the number of tokens that will be paid from the DAO reserve for its execution. + +!!! info + The members of the DAO agree between themselves how to evaluate the Tasks. + +After attaching a pull request to the Task, the tokens will be distributed between the author, reviewer and manager in the ratio you set. + +**Commit author** - the person who executes the Task. +**Reviewer** - the person who checks the correctness of the Task. +**Manager** - the person who manages the Task execution process. + +!!! info + The number of authors, areviewers and managers is set at your choice. + +![](../../images/gosh_web_Task_04_cost_distrb.jpg) + +Select vesting and lock periods. + +**Lock (cliff)** - the period after which the reward payments will begin. +The countdown will start after accepting the proposal about completing the Task. +**Vesting** - rules for transferring the fixed part of the tokens to the disposal of the contractor. + +For example, lock - 12 months, vesting - 2 months. + +!!! warning + In order for the investment scheme to be correct, the smaller of the number of tokens allocated to the members of the task must be a multiple of the number of months of investment. + +![](../../images/gosh_web_Task_05_lock_vesting.jpg) + +Add a comment the token distribution rules and click **Create task and start proposal** + +![](../../images/gosh_web_Task_06_comment.jpg) + +After creating the proposal, you will be taken to the **DAO** tab with events. + +![](../../images/gosh_web_Task_07_event.jpg) + +Inside the proposal you will be able to see all the conditions of the Task. +In the table you can see the period since which month and in what parts the payments will be made to the members of the Task. + + + +![](../../images/gosh_web_Task_09_event_details.jpg) + +After accepting the proposal, the Task will appear in the list on the **Tasks** tab with the status *Awaiting commits*. + +!!! info + When creating a Task the tokens (Task cost) from the DAO-reserve are written off and reserved on the Task-contract. + +![](../../images/gosh_web_Task_10_list_tasks.jpg) + +When the Author has completed the Task, he adds it to the commit. + +!!! info + If you need to make several commits to complete a Task,, create a separate branch. + +And do **Select task** when creating the proposal to the pull request. + +Select the Task performed(s), reviewer(s), manager(s) if they worked on the task. The allocated shares of those who were not specified will be returned to the DAO-reserve. + +![](../../images/gosh_web_Readme_md_03_data_commit.jpg) + +After that a proposal to the pull request will be created. + +![](../../images/gosh_web_Task_12_proposal_to_commit_with_task.jpg) + +Detailed information can be viewed by going to it on the DAO tab with events. + +![](../../images/gosh_web_Task_13_detail_proposal.jpg) + +If the reviewer was specified during the commit, the event will wait for verification from them. + +![](../../images/gosh_web_Task_14_event%20review.jpg) + +Then, after the reviewer send the solution, it will be possible to vote for the proposal. +When the pull request is accepted, the Task status will change to **Confirmed**. + +![](../../images/gosh_web_Task_15_task_status_confirmed.jpg) + +After the lock period ends, the members of the Task can receive a reward. +To do this, go to the **Tasks** tab in the completed Task and click **Claim reward**. + +!!! note + If Lock period (cliff) has been set to zero, then you can click **Claim reward** immediately after accepting the pull request. + +![](../../images/gosh_web_Task_16_claim_reward.jpg) + +Thus the tokens will begin to be transferred to the wallets of the members of the completed Task in accordance with the vesting scheme when the lock period ends. + + +### __Deletе Task__ + + +To delete a Task, go to it on the **Tasks** tab. +And click to **Delete task** + +![](../../images/gosh_web_Task_delete_01.jpg) + +After creating a proposal about deleting a Task, you will be redirected to the event tab **Dao**. + +![](../../images/gosh_web_Task_delete_02_event.jpg) + +When the proposal is accepted, the Task will be deleted. +The tokens allocated for this Task will be returned to the DAO reserve. + diff --git a/docs/working-with-gosh/gosh-web/working-with-tokens-and-karma.md b/docs/working-with-gosh/gosh-web/working-with-tokens-and-karma.md new file mode 100644 index 0000000..2451a4d --- /dev/null +++ b/docs/working-with-gosh/gosh-web/working-with-tokens-and-karma.md @@ -0,0 +1,122 @@ + + + +#### Additional minting of tokens for DAO + +!!! warning + The option allowing the minting of DAO tokens must be enabled on the **Settings** tab in the **Token Settings section**. + +Click on the **Mint** button on the right on the **Overview** tab in the **DAO Reserve** section. +You will create an proposal to mint additional tokens for this DAO. + +In the window that appears, enter the amount of tokens to emission and add a description of the DAO members. Then click **Create proposal to mint tokens** + +![](../../images/gosh_web_OVERVIEW_mint_01_create_proposal.jpg) + +After creating the proposal, you will be redirected to the **DAO** tab with events. + +![](../../images/gosh_web_OVERVIEW_mint_02_event.jpg) + +Inside the event, you can get details of proposal. + +![](../../images/gosh_web_OVERVIEW_mint_03_proposal_details.jpg) + +After the proposal is accepted, the changes will take effect. + +![](../../images/gosh_web_OVERVIEW_mint_04_reserve.jpg) + +#### Additional voiting tokens and Karma + +Any member of the DAO can send a request to change Karma. +To do this, go to the **Members** tab and change the number of Karma and token balance of one or more DAO members, including for yourself. + +!!! warning + To create an proposal, you must have at least 20 tokens on your wallet balance. + +![](../../images/gosh_web_memeber_change_karma_01_request.jpg) + +!!! Warning + Be careful when distributing karma among the members of the DAO. + Avoid the possibility of a preponderance in the votes of one of the DAO members. + To avoid a situation where one participant will be able to transfer the entire balance of the DAO to his wallet. + +Then click **Save changes and create proposal**. +As a result, a Multi proposal will be created and you will be redirected to the event tab **Dao**. + +![](../../images/gosh_web_memeber_change_karma_02_event.jpg) + +Inside the event, you can get details of Multi proposal. + +![](../../images/gosh_web_memeber_change_karma_03_detal_multi_proposal.jpg) + +After accepting the multi proposal, the user will receive tokens and Karma from DAO reserve. This can be seen on the **Members** tab. + +![](../../images/gosh_web_memeber_change_karma_04_check_user_data.jpg) + + + +#### __Expert Tags__ + +You can now [add an **Karma Tags**](../../hacks-and-grants/user-guide.md#expert-tags) to your DAO, which will grant additional Karma Voting Powers to each member possessing such Tags for decisions that support Karma Tags. + + + +#### Transfer of tokens from DAO reserve + +Tokens can be sent from the DAO reserve to + +* a member of this DAO; +* any GOSH user, who has visited this DAO at least once. + + +To do this, on the **Overview** tab in the **DAO reserve** section, click **Send**. + +![](../../images/gosh_web_send_token_01_overview.jpg) + +In the window that opens, enter the name of the GOSH user or the name of the DAO and the amount of tokens to send. + +If you want the recipient's Karma to increase jointly with the token balance, then check this box. +Also write a description for the token transfer. This will help the DAO members to make a decision when voting. + +!!! Warning + Be careful when distributing karma among the members of the DAO. + Avoid the possibility of a preponderance in the votes of one of the DAO members. + To avoid a situation where one participant will be able to transfer the entire balance of the DAO to his wallet. + +Then click **Create proposal to send tokens** + +![](../../images/gosh_web_send_token_02_window_send.jpg) + +After creating the offer, you will be redirected to the **DAO** page with events. + +![](../../images/gosh_web_send_token_03_event.jpg) + +Inside the event, you can see detailed information about the proposal. + +![](../../images/gosh_web_send_token_04_detaol_event.jpg) + +After the proposal is accepted, the tokens will be transferred to the balance wallet of the GOSH user or DAO. + +#### Transfer of tokens from user's wallet + +Tokens can be sent from the DAO reserve to + +* a member of this DAO; +* any GOSH user, who has visited this DAO at least once. + +!!! info + Only regular tokens are transferred. You will not be able to vote with such tokens. + +To send tokens from your wallet to the DAO, go to the **Overview** or **DAO** tab on the **Your wallet balance** section and click **Send**. + +![](../../images/gosh_web_send_token_05_from_wallet_overview.jpg) + +In the window that opens, enter the name of the member of the DAO and the amount of tokens to send. +Then click **Send tokens** + +![](../../images/gosh_web_send_token_06_window_send.jpg) + +After that, the tokens will be transferred to the recipient's wallet balance. + +![](../../images/gosh_web_send_token_07_balans_resipient.jpg) + diff --git a/mkdocs.yml b/mkdocs.yml index 9ef4756..78c181c 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,41 +1,54 @@ site_name: GOSH nav: - - Git Open Source Hodler: index.md - - On-chain Architecture: - - GOSH Wallet: on-chain-architecture/gosh-wallet.md - - Organizations - GOSH DAO and SMV: on-chain-architecture/organizations-gosh-dao-and-smv.md - - GOSH smart contracts: on-chain-architecture/gosh-smart-contracts.md - - Working with GOSH: - - GOSH Web: working-with-gosh/gosh-web.md - ## - Overview: empty.md - # - DAO: empty.md - # - Repositories: empty.md - # - Members: empty.md - # - Tasks: empty.md - # - Settings: empty.md - - Docker Extension: working-with-gosh/docker-extension.md - - Git Remote Helper: working-with-gosh/git-remote-helper.md - - AnyTree: working-with-gosh/anytree.md - - AnyTree Firewall for Telepresence: working-with-gosh/anytree-firewall-for-telepresence.md - - GOSH AI: working-with-gosh/gosh-ai.md - #- Build and Sign Images: working-with-gosh/build-and-sign-images.md - #- Verify Images in Docker Extension: working-with-gosh/verify-images-in-docker-extension.md - - AnyTree: anytree-all.md + - User Guide(WIP): + - Overview: + - Git Open Source Hodler: user-guide/git-open-source-hodler.md + - Motivation: user-guide/motivation.md + - Objective: user-guide/objective.md + - Architecture: user-guide/architecture.md + - Instruments and utilities: user-guide/instruments-and-utilities.md + - Working with GOSH: + - GOSH Web(WIP): + - Account: working-with-gosh/gosh-web/account.md + - DAO: + - Create DAO: working-with-gosh/gosh-web/create-dao.md + - DAO Overview: working-with-gosh/gosh-web/dao-overview.md + # - DAO Set up and upgrade: working-with-gosh/gosh-web/dao-set-up.md + - Proposals and voting in SMV: working-with-gosh/gosh-web/proposals-and-voting-in-smv.md + - Working with tokens and Karma: working-with-gosh/gosh-web/working-with-tokens-and-karma.md + - Repositories: working-with-gosh/gosh-web/repository.md + - Members: working-with-gosh/gosh-web/members.md + - Tasks: working-with-gosh/gosh-web/task.md + - Settings: working-with-gosh/gosh-web/dao-set-up.md + - GOSH Ethereum L2: + - Overview: ethereum-L2/overview.md + - User Guide: ethereum-L2/user-guide.md + - Hacks & Grants: + - Overview: hacks-and-grants/overview.md + - User Guide: hacks-and-grants/user-guide.md + - Docker Extension(WIP): working-with-gosh/docker-extension.md + - Git Remote Helper(WIP): working-with-gosh/git-remote-helper.md + - AnyTree(WIP): + - AnyTreeAll: anytree-all.md #- Working with AnyTree: working-with-gosh/anytree.md #- Working with AnyTree without GOSH: anytree/anytree-without-gosh.md - - GOSH Ethereum L2: - - Overview: ethereum-L2/overview.md - - User Guide: ethereum-L2/user-guide.md - - Hacks & Grants: - - Overview: hacks-and-grants/overview.md - - User Guide: hacks-and-grants/user-guide.md - - Acki Nacki: - - Overview: acki-nacki/overview.md - - Integrations: + - AnyTree: working-with-gosh/anytree.md + - AnyTree Firewall for Telepresence: working-with-gosh/anytree-firewall-for-telepresence.md + - GOSH AI: working-with-gosh/gosh-ai.md + - For developers(WIP): + - On-chain Architecture: + - GOSH Wallet: on-chain-architecture/gosh-wallet.md + - Organizations - GOSH DAO and SMV: on-chain-architecture/organizations-gosh-dao-and-smv.md + - GOSH smart contracts: on-chain-architecture/gosh-smart-contracts.md + - Set up Git Remote Helper: working-with-gosh/gosh-web/grh-config.md + - Acki Nacki Protocol(WIP): + - Overview: acki-nacki/overview.md - GOSH GitHub Sync: integrations/sync.md - GOSH Ethereum L2: integrations/l2.md # - contracts: integrations/contracts.md - Links: links.md + #- Build and Sign Images: working-with-gosh/build-and-sign-images.md + #- Verify Images in Docker Extension: working-with-gosh/verify-images-in-docker-extension.md markdown_extensions: - admonition diff --git a/site/404.html b/site/404.html index 9064ac5..e9afc31 100644 --- a/site/404.html +++ b/site/404.html @@ -166,52 +166,43 @@ -
  • - - - - - Git Open Source Hodler - - -
    • - - + -
  • - + - On-chain Architecture + User Guide(WIP)
    • + + + +
  • + + + - -
  • - - - Working with GOSH + Docker Extension(WIP) - -
    • - + + @@ -220,12 +211,12 @@
  • - + - AnyTree + Git Remote Helper(WIP)
    • @@ -239,10 +230,10 @@
  • - + - GOSH Ethereum L2 + AnyTree(WIP)
    • @@ -254,17 +245,16 @@ +
  • + + + - -
  • - - - Hacks & Grants + GOSH AI - -
    • - + + @@ -274,35 +264,26 @@ -
  • - - - - Acki Nacki - - -
    • - - - -
  • - + - Integrations + For developers(WIP)
    • + + + @@ -364,22 +345,44 @@ -
  • - + + + + + + + + +
  • + + + + + + + + + -
    • - - - - - + + + +