decredcommunity / issues

Decred community issue tracker
5 stars 0 forks source link

Amend the Decred Constitution #107

Closed noahpierau closed 5 years ago

noahpierau commented 5 years ago

There seems to be social consensus that we should amend the constitution.

This is the rough process: 1) discuss scope and nature of amendment. 2) post about a tentative plan to /r/decred. 3) open docs PR that amends the constitution. 4) submit Politeia proposal to ratify amendment.

Active PR: https://github.com/decred/dcrdocs/pull/860

Discussions:

xaur commented 5 years ago

The proposal can ratify both the amendment (diff) and the full amended version. Noting this since there was no voting to ratify the initial constitution. Doing both in one go is nice.

Dustorf commented 5 years ago

I think that's a good idea, xaur. It looks to me like the only two areas in need of amending are project governance and funding. LMK if you agree.

xaur commented 5 years ago

Need to check the discussion, but I remember there were some incorrect bits that need to be removed. Pinging @RichardRed0x since he suggested the idea to ratify constitution on Politeia.

Since the proposal will be to amend the constitution document, it will be nice if complete information about the change is recorded in the resilient Politeia file system.

Complete information includes:

  1. text of the proposal
  2. old constitution doc
  3. new constitution doc

This way both old and new constitution are ratified and stored forever in Politeia. In Markdown format, they are very light (a few kilobytes each). The two docs can be diffed to view only the change.

Need to clarify if Politeia allows to attach a second Markdown file.

Whoever picks the writing, I recommend to put pre-proposal (and possible accompanying old and new constitution files) in a gist, and share the link everywhere.

P.S. man I wish nation state laws were handled like this, written in Markdown, stored and versioned in Git! Let's set a decent example.

RichardRed0x commented 5 years ago

Good suggestions @xaur . Markdown attachments are not allowed, only png and txt. Having the old and new versions and diff on Pi is a nice idea though. The document is such that having markdown in a txt file would probably not be too bad (just some * and ##, no links that really screw with reading markdown as txt).

I agree that that's where the changes are @Dustorf

If there is consensus that what we want for now is an amendment which removes old inaccurate information and adds statements about missing things (like Politeia), I would be up for taking on the role of shepherding this along.

Dustorf commented 5 years ago

+1 on Richard taking a first crack on this and then we can review and discuss

xaur commented 5 years ago

As txt it would work fine, like any "lightweight markup" markdown is human readable in raw form. The key is that the files will be anchored and stored in a super simple format that can be read on any device. I would suggest some extra restrictions for such files: ASCII-only charset, no BOM, LF line endings.

RichardRed0x commented 5 years ago

Thoughts on this as I'm drafting it:

noahpierau commented 5 years ago

Edits to the Introduction and Blockchain Governance sections look good! I personally think that we could have less detail in the Blockchain Governance section and link to relevant pages of the docs instead. We also need to think more carefully about the Project Governance and Funding section. What information is necessary to include in each point? How can we present these points in a logical order? All in all, this is a great starting point. Thank you for taking the initiative @RichardRed0x

xaur commented 5 years ago

Updated issue description to include discussions. You can see past versions by clicking "edited..." down arrow.

noahpierau commented 5 years ago

After this comment I haven't seen much action around the constitution discussion: https://www.reddit.com/r/decred/comments/asnl21/should_we_scrap_the_decred_constitution/egwfo3a

Shall we just open a PR for the latest version and put it up for vote on Politeia?

xaur commented 5 years ago

@noahpierau there is a PR open in dcrdocs and some discussion.

I'm not up to date on all discussions that took place, but in any case I support the idea to update the constitution while trying to minimize the diff. The immediate benefit is a constitution up to date with current state of things and less confusion. Ditching it entirely is a more radical move that should be voted separately.

+1 to post on Politeia, it would push the issue forward. Also, based on feedback new iterations of the draft can be made.

I suggest that first revision of the proposal attaches existing constitution and first draft of its amended version as text files. Any revisions of the proposal should attach updated draft of the amended version. This way all drafts are recorded on Politeia properly and can be diffed.

@lukebp does Politeia handle updates of attached files in proposal revisions? By handle I mean allow to overwrite existing attachment and store both old and new version of the attachment in Git.

lukebp commented 5 years ago

does Politeia handle updates of attached files in proposal revisions? By handle I mean allow to overwrite existing attachment and store both old and new version of the attachment in Git.

Yes.

xaur commented 5 years ago

Noticed you didn't use attachments in the proposal @RichardRed0x, were there any problems with them?

RichardRed0x commented 5 years ago

There is an issue with markdown files (or any text files) being attached to proposals. Even one is too many. This PR should address it, but it is not yet merged.

xaur commented 5 years ago

https://github.com/decred/dcrdocs/pull/860 is merged and the new constitution is live. Thanks all! Closing.