Updated ZIP Process Proposal

Important for the future of Zcash protocol development! Here’s the link: https://github.com/zcash/zips/pull/206

@acityinohio wrote:

Submitting a PR for an updated ZIP process guideline. A final number would be assigned if this is approved by the current Editor and reaches consensus.

As part of this proposal, I’d also support the zips repo being transferred to the Zcash Foundation GitHub org, with all the links being appropriately updated.

Feedback very much welcome!

Click through into the commits for more details. That’s this part of the GitHub interface:

Please leave any substantive feedback on the GitHub thread :slight_smile: Discussion here is fine too, but the serious back-and-forth should stay in one place.

5 Likes

I’d much prefer markdown over mediawiki. Can’t say I’m the biggest restructured text fan but there are a lot of different markups being used as documentation is in rst for example.

As part of this proposal, I’d also support the zips repo being transferred to the Zcash Foundation GitHub org, with all the links being appropriately updated.

What’s the rationale behind this? I’d understand if the repo was in the Company repo but surely it makes sense in the zcash repo? This, I would think, just makes it harder to find.

2 Likes

Good point. The Foundation could maintain an up-to-date fork, or something along those lines? @acityinohio maybe you could expand on the rationale?

I suppose it wouldn’t be a problem to keep a fork, but more ideal would be a single remote repository that’s considered the canonical spot for discussion and maintenance.

What’s the rationale behind this? I’d understand if the repo was in the Company repo but surely it makes sense in the zcash repo? This, I would think, just makes it harder to find.

My understanding is that the Zcash GitHub org is the Zcash Company’s GitHub org — but I could be wrong (it’s hard to tell since it does not contain any public members). I would prefer the ZIPs be hosted in an organization separate from the Company. If the ZIPs were to stay there, in my view it would be best to have at least one Foundatoin admin on that org, but I’m obviously biased.

I’d much prefer markdown over mediawiki. Can’t say I’m the biggest restructured text fan but there are a lot of different markups being used as documentation is in rst for example.

I totally understand that as well — I’m not an rst fan which is why I switched back to mediawiki (and since BIPs were/are written in that markup). Markdown would certainly be the simplest option and I’d be open to it reformatting completely in vanilla markdown if current ZIP users/editor/people would generally prefer it.

Right, I don’t think it’s the company’s repo (as that is Electric Coin Company · GitHub) but the company are the only ones with access… Personally I’ve always considered it the project repo and just they never granted anyone else access (which obviously should be very restrictive).

I definitely agree it should be a single repository but that zcash/zips is the more sensible one but that you have write access to it. If you don’t get access then that answers that…

1 Like

Ah thanks for providing that link @garethtdavies! I didn’t realize they had a separate repo.

Agreed, and updated the PR with a comment to reflect that view on that as well. (edit: also converted back to .rst for consistency with prior zips)