Skip to content
This repository has been archived by the owner on Jun 29, 2022. It is now read-only.

Major reorg and introduction of spec status & governance #125

Merged
merged 1 commit into from
Jun 5, 2019

Conversation

rvagg
Copy link
Member

@rvagg rvagg commented May 28, 2019

WIP I suppose; I don't imagine this will be straightforward.

This is probably best assessed by viewing through the branch rather than trying to make sense of some of the diffs (especially README): https://github.com/ipld/specs/tree/rvagg/big-reorg

Inspired in part by the governance proposal at #122 (included here, but in the README) which focuses on specifications, but we have more than just specifications as #123 makes clear (as does a lot of the existing content).

  • Divided into one directory per layer (sort of aligns with @warpfork's proposal from our Berlin team week but we've lost the specifics of that proposal, and I don't remember it, so it's not the same).
  • Documents divided into "Specification" or "Concept"
  • README trimmed of old concept/glossary content--moved to individual files or within existing files where there's overlap
  • Added Specification status descriptors in README and each spec doc
  • Added governance from [WIP] Initial work on contributing guidelines for specifications #122
  • Removed ancient REQUIREMENTS.md (I couldn't find anything in here that was useful and wasn't already restated in some new way, made redundant by new work or was included in WIP content)

Edits to README look bigger than they are because I went with a more consistent line-break strategy than we have now of break-on-sentence.

- Divided into one directory per layer
- Documents divided into "Specification" or "Concept"
- README trimmed of Concept content--moved to individual files
- Added Specification status descriptors in README and each spec doc
- Added governance from #122
- Removed ancient REQUIREMENTS.md
@rvagg rvagg requested review from mikeal, vmx and warpfork May 28, 2019 11:12
@mikeal
Copy link
Contributor

mikeal commented Jun 5, 2019

I’m planning on writing a bunch of specs today and I want this merged beforehand so I’m clicking the button :)

@mikeal mikeal merged commit b126370 into master Jun 5, 2019
@rvagg
Copy link
Member Author

rvagg commented Jun 5, 2019

👌 brilliant, now I need to get more content in!

@rvagg rvagg deleted the rvagg/big-reorg branch June 5, 2019 23:18
Stebalien pushed a commit to Stebalien/specs that referenced this pull request Sep 18, 2019
Create aggregating-storage-submissions.md
prataprc pushed a commit to iprs-dev/ipld-specs that referenced this pull request Oct 13, 2020
- Divided into one directory per layer
- Documents divided into "Specification" or "Concept"
- README trimmed of Concept content--moved to individual files
- Added Specification status descriptors in README and each spec doc
- Added governance from ipld#122
- Removed ancient REQUIREMENTS.md
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants