Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add notes about disputes #75

Merged
merged 7 commits into from
Nov 14, 2023
Merged

Add notes about disputes #75

merged 7 commits into from
Nov 14, 2023

Conversation

maltekliemann
Copy link
Contributor

Just getting the ball rolling on getting the docs up to speed.

@vercel
Copy link

vercel bot commented Dec 18, 2022

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Nov 10, 2023 4:00pm

@maltekliemann
Copy link
Contributor Author

@Chralt98 Can you take a quick peek at this and tell me if this is still required or if there's any overlap?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I mean we still offer authorized markets on the polkadot js and ultimately in our protocol for main-net. However the decentralised court system should be fully controlling the dispute resolution by the time it is applied to the main-net. So, I think this deprecated functionality shouldn't be mentioned in the documentation.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we mention here that the advisory committee can close markets early?

I am also currently wondering if we need this, if we have the more advanced feature of closing markets early (with fat finger protection).

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I mean we still offer authorized markets on the polkadot js and ultimately in our protocol for main-net. However the decentralised court system should be fully controlling the dispute resolution by the time it is applied to the main-net. So, I think this deprecated functionality shouldn't be mentioned in the documentation.

Authorized is not deprecated though.

@@ -21,6 +21,11 @@ platform. It is allowed to make the following decisions:
- Reject advised markets if they are deemed valid (requires majority approval)
- Close markets (requires two-thirds approval) or destroy markets (requires full
approval) which are in gross violation of our rules of conduct
- Resolve disputes for markets with the [Authorized] dispute mechanism
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Resolve disputes for markets with the [Authorized] dispute mechanism

Comment on lines +28 to +31

<!-- Links -->

[authorized]: ./using-zeitgeist-markets.md#disputes
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<!-- Links -->
[authorized]: ./using-zeitgeist-markets.md#disputes

Every time a report is submitted (by the oracle or a stand-in), the market is
not resolved for another 24 hours. During this period of time, other users can
submit a _dispute_ if they believe that the report is incorrect.
When a report is submitted (by the oracle or a stand-in), the market is not
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the stand-in the outsider? Can we avoid naming conflicts here?

docs/learn/using-zeitgeist-markets.md Outdated Show resolved Hide resolved
resolved for a certain window of time called the _dispute period_. During this
period of time, other users can submit a _dispute_ if they believe that the
report is incorrect. To do so, they stake a certain amount of ZTG, the _dispute
bond_ and report the outcome they believe to be correct (the _suggestion_).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
bond_ and report the outcome they believe to be correct (the _suggestion_).
bond_.

Comment on lines 253 to 254
How the dispute is resolved depends on what _dispute mechanism_ was selected
during market creation. The currently available dispute mechanisms are:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
How the dispute is resolved depends on what _dispute mechanism_ was selected
during market creation. The currently available dispute mechanisms are:
How the dispute is resolved depends on the [decentralized court] _dispute mechanism_.

Comment on lines 256 to 260
- _Authorized_: After the market has been disputed, the [Advisory Committee]
decides which outcome the market will resolve to.
- _[Decentralized Court]_ (currently disabled): A group of randomly selected
jurors vote secretly to find a [Schelling point] among the market's outcomes,
which is then used as the resolved outcome.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- _Authorized_: After the market has been disputed, the [Advisory Committee]
decides which outcome the market will resolve to.
- _[Decentralized Court]_ (currently disabled): A group of randomly selected
jurors vote secretly to find a [Schelling point] among the market's outcomes,
which is then used as the resolved outcome.
In short: A group of randomly selected jurors vote secretly to find a [Schelling point] among the market's outcomes, which is then used as the resolved outcome.

docs/learn/using-zeitgeist-markets.md Outdated Show resolved Hide resolved
docs/learn/using-zeitgeist-markets.md Outdated Show resolved Hide resolved
@Chralt98
Copy link
Member

Chralt98 commented Nov 1, 2023

I didn't check the non-modified lines of this file. I think if we just mention court as the dispute mechanism we are fine for the future, because why mentioning (soon) deprecated code?

Co-authored-by: Chralt <chralt.developer@gmail.com>
@maltekliemann maltekliemann merged commit bda2218 into main Nov 14, 2023
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants