Initial process upgrades for Multiformats registry group and org

.github/ISSUE_TEMPLATE/BUG-REPORT.yml

@@ -0,0 +1,31 @@
+name: "Bug Report - documentation or registries"
+description: Report possible bugs in multiformats spec, process docs, and/or the multiformats-wide registry.
+title: "🐛 [DOC/PROCESS BUG] - <title>"
+labels: [
+  "bug"
+]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: "Description"
+      description: Please enter an explicit description of your issue,  
+      placeholder: Short and explicit description of your incident, ideally with commit-specific link to lines
+    validations:
+      required: true
+  - type: input
+    id: reprod-url
+    attributes:
+      label: "Reproduction URL"
+      description: Please enter your GitHub URL to provide a reproduction of the issue
+      placeholder: ex. https://github.com/multiformats/multiformats/
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: "Context"
+      description: Please provide additional context
+      placeholder: "Context or external links needed to explain the possible mistake"       
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/IMPLEMENTATION-REGISTRATION.yml

@@ -0,0 +1,37 @@
+name: "Register multi- Multi- Implementation"
+description: Register a completec and conformant implementation of 2 or more multiformats
+title: "📚 [NEW PROJECT] - <title>"
+labels: [
+  "implementation"
+]
+body:
+  - type: input
+    id: name
+    attributes:
+      label: "Name"
+      description: Under what name can developers find this multi-XX implementation (say, as a library in package managers)
+      placeholder: (language/framework)-Multi(projects) is the default template
+    validations:
+      required: false
+  - type: checkboxes
+    attributes:
+      label: "Have read contributing"
+      description: I have read the [contributing](./contributing.md) document
+      options:
+      - label: I read it!
+    validations:
+      required: true
+  - type: checkboxes
+    attributes:
+      label: "Tests complete and passing"
+      description: I have tested it against existing libraries using test cases in each multi repo
+      options:
+      - label: Tests pass!
+    validations:
+      required: true
+  - type: textarea
+    id: solution_and_rationale
+    attributes:
+      label: "Unique properties"
+      description: Unique strengths, properties, or use-cases supported compared to other implementations.
+      placeholder: Details welcome!   

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Protocol Labs Vulnerability Disclosure Team
+    url: mailto:security@ipfs.io
+    about: Please do NOT open issues related to security of implementations or spec here without contacting the IPFS security team first.

README.md

@@ -7,17 +7,23 @@
 
 > The main repository for discussing multiformats
 
-Currently, we have the following formats. More formats are being discussed and worked on.
+Multiformats is a set of self-describing protocol values. 
+These values are foundational in that they are low-level building blocks for both data and network layers of the composable protocols making up IPFS, IPLD, libp2p, and many other decentralized data systems. 
+This repository's issues and pull requests are currently the primary venue for the coordination between the various registries making up the group, each of which is separately being hardened as specifications and public, formal registries over time.  
+See [contributing.md][./contributing.md] for more details on governance and process.
 
-| Repo | Captain | Status | IETF |
+## Current Registries
+
+Currently, we have the following formats, each of which corresponds to a specification and a registry. 
+More formats are being discussed and may be added over time, but the following are the mature ones to date:
+
+| Repo | Maintainer | Status | IETF |
 |------|---------|--------|------|
 | [multiaddr](https://github.com/multiformats/multiaddr)| @lgierth | stable | [WIP](https://github.com/multiformats/multiaddr/tree/doc/internet-draft) |
-| [multibase](https://github.com/multiformats/multibase) | @jbenet | stable | [W3C DVCG](https://github.com/w3c-dvcg/multibase) |
-| [multicodec](https://github.com/multiformats/multicodec)| @jbenet | stable | TODO |
-| [multihash](https://github.com/multiformats/multihash)| @jbenet | stable | [W3C DVCG](https://github.com/w3c-dvcg/multihash) |
-| [multistream](https://github.com/multiformats/multistream)| @diasdavid | stable | TODO |
-| [multigram](https://github.com/ipfs/specs/pull/123) | | WIP | TODO |
-| [multikey](https://github.com/ipfs/specs/issues/58) | | WIP | TODO |
+| [multibase](https://github.com/multiformats/multibase) | @jbenet | stable | [W3C CCG](https://github.com/w3c-ccg/multibase) |
+| [multicodec](https://github.com/multiformats/multicodec)| @jbenet | stable | TBD |
+| [multihash](https://github.com/multiformats/multihash)| @jbenet | stable | [W3C CCG](https://github.com/w3c-ccg/multihash) |
+| [multikey](https://github.com/ipfs/specs/issues/58) | @protocol | WIP | TBD |
 
 See the project directory, below, for implementations and other related repositories.
 
@@ -26,58 +32,67 @@ See the project directory, below, for implementations and other related reposito
 
 ## Table of Contents
 
-- [Background](#background)
-  - [An Example: Multihash](#an-example-multihash)
-  - [A note on the word Multiformats](#a-note-on-the-word-multiformats)
-- [Project Directory](#project-directory)
-  - [Protocols](#protocols)
-  - [Protocols in Progress](#protocols-in-progress)
-  - [Implementations](#implementations)
-    - [Go Implementations](#go-implementations)
-    - [JavaScript Implementations](#javascript-implementations)
-    - [Other Implementations](#other-implementations)
-  - [Other Repositories](#other-repositories)
-- [Contribute](#contribute)
-- [License](#license)
+- [multiformats](#multiformats)
+  - [Current Registries](#current-registries)
+  - [Table of Contents](#table-of-contents)
+  - [Background](#background)
+    - [A note on the word Multiformats](#a-note-on-the-word-multiformats)
+  - [Project Directory](#project-directory)
+    - [Implementations](#implementations)
+      - [Multiaddr Implementations](#multiaddr-implementations)
+      - [Multihash Implementations](#multihash-implementations)
+      - [Multicodec Implementations](#multicodec-implementations)
+      - [Other Implementations](#other-implementations)
+    - [Other Repositories](#other-repositories)
+  - [Maintainers](#maintainers)
+  - [Contribute](#contribute)
+  - [License](#license)
 
 ## Background
 
-Every choice in computing has a tradeoff. This includes formats, algorithms, encodings, and so on. And even with a great deal of planning, decisions may lead to breaking changes down the road, or to solutions which are no longer optimal. Allowing systems to evolve and grow is important.
+Every choice in computing has a tradeoff. 
+This includes formats, algorithms, encodings, and so on. 
+And even with a great deal of planning, decisions may lead to breaking changes down the road, or to solutions which are no longer optimal. 
+Allowing systems to evolve and grow is important.
 
-Multiformats is a collection of protocols which aim to future-proof systems, today. They do this mainly by allowing data to be self-describable. This allows interoperability, protocol agility, and helps us avoid lock in. Currently, our protocols (both works in progress and implemented) cover the following areas:
+Multiformats is a collection of protocols which aim to future-proof systems, today. 
+They do this mainly by allowing data to be self-describable. 
+This allows interoperability, protocol agility, and helps us avoid various forms of lock-in.
+Currently, these interlocking protocols (both works in progress and implemented) cover the following areas:
 
 - [multiaddr](https://github.com/multiformats/multiaddr): network addresses
 - [multibase](https://github.com/multiformats/multibase): base encodings
 - [multicodec](https://github.com/multiformats/multicodec): serialization codes
-- [multigram](https://github.com/multiformats/multigram): protocol negotiation and multiplexing over datagrams
 - [multihash](https://github.com/multiformats/multihash): cryptographic hashes
 - [multikey](https://github.com/ipfs/specs/issues/58): cryptographic keys and artifacts
-- [multistream](https://github.com/multiformats/multistream): stream wire protocols
-- [multistream-select](https://github.com/multiformats/multistream-select): Friendly protocol multiplexing.
 
-The self-describing aspects of the protocols have a few stipulations:
+Several of the multiformats are stable, and work on the others is ongoing.
+Implementers and refiners of the drafts of any one of these registries or their tooling are welcome to [contribute](./contributing.md), without needing to understand deeply or track progress on the others. 
+Across these otherwise quite different use-cases and mechanisms, the self-describing aspects of the protocols have a few stipulations in common:
 
-- they must be in the value (not passed in out of band, in function calls, implicit choices, or documentation);
+- the "prefixes" use to self-describe a value must be inline with the value (not passed out-of-band, in function calls, implicit choices, or documentation);
 - they must be compact and have a binary-packed representation (as opposed to a sparser encoding) or they will hinder performance;
-- they must have a human readable representation.
-
-Several of the multiformats are stable, and we're working on the others. We are trying to prioritize their usage as soon as possible. What they offer -- protocol interoperability and future-proofing --  would have real-world consequences.
-
-Towards that end, we are encouraging implementations of these protocols; if you know of any, please link them here (or add them to the organization!).
+- they must have a human-readable representation.
 
 ### A note on the word Multiformats
 
-Multiformats is the name for the organization, but it can also be used to refer to protocols; for instance, in the sentence "Use one of the multiformats". Formats is interchangeable with protocols, here. We try to capitalize Multiformats when it refers to the organization, on GitHub.
+`Multiformats` is the name for the community (and the "organization" in GitHub's access control model), but `multiformats` can also be used to refer to protocols; for instance, in the sentence "Use one of the multiformats". 
+Formats is interchangeable with protocols, here, as each format is designed in tandem with one or more protocols which handle those self-describing values centrally. 
+We try to capitalize Multiformats when it refers to the organization.
 
 ## Project Directory
 
 Below, a list of all of the projects in the Multiformats organization is listed.
 
-**Captains** are the active leads for each project. Their responsibilities are to make sure that issues and pull requests are attended to in a timely manner, and general upkeep. If you have questions about a repository, or need feedback, please contact them as appropriate.
+**Maintainers** are the active leads for each project, even if the specification is still under construction. 
+Their responsibilities are to make sure that issues and pull requests are attended to in a timely manner, and general upkeep. 
+If you have questions about a repository, or need feedback, please contact them as appropriate. 
+If any of the specifications defining these formats are formalized and finalized in a standards body, these maintainers may continue on as Registrars of the table of entries which can keep growing after stabilizing the syntax and tooling interfaces.
 
 ### Implementations
 
-As well as specifications, we also have some implementations in the organization
+As well as specifications, we also have some implementations checked into and maintained through the GitHub organization.
+Checking in implementation code here is not a requirement of listing here, unless maintainership is being transferred.
 
 #### Multiaddr Implementations
 
@@ -155,15 +170,11 @@ As well as specifications, we also have some implementations in the organization
 
 ## Contribute
 
-Please contribute! [Dive into the issues](https://github.com/multiformats/multiformats/issues)!
-
-Check out our [contributing document](contributing.md) for more information on how we work, and about contributing in general. Please be aware that all interactions related to multiformats are subject to the IPFS [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).
-
-If you're interested in proposing a new format (in addition to multihash, multistream, and so on), [open an issue](https://github.com/multiformats/multiformats/issues/new) in this repository, explaining the name of the format, what it is for, and why you think it should become one of the multiformats. Pointing to any existing implementations would also be great, if there are any. If you want to implement a multiformat in a new language, open an issue in the main repository for the relevant multiformat: for instance, if you want to write rust-multicodec, open an issue in the multiformats/multicodec repository. This will allow others to know that you're working on it, and potentially join in the effort.
-
-Small note: If editing the README, please conform to the [standard-readme](https://github.com/RichardLitt/standard-readme) specification.
+Check out our [contributing document](contributing.md) for more information on how we work, and about contributing in general.
 
 ## License
 
-This repository is only for documents. All of these are licensed under the [CC-BY-SA 3.0](https://ipfs.io/ipfs/QmVreNvKsQmQZ83T86cWSjPu2vR3yZHGPm5jnxFuunEB9u) license © 2016 Protocol Labs Inc. Any code is under a [MIT](LICENSE) © 2016 Protocol Labs Inc.
+This repository is only for documents. 
+All of these are licensed under the [CC-BY-SA 3.0](https://ipfs.io/ipfs/QmVreNvKsQmQZ83T86cWSjPu2vR3yZHGPm5jnxFuunEB9u) license © 2016 Protocol Labs Inc. Any code is under a [MIT](LICENSE) © 2016 Protocol Labs Inc.
 
+[Code of Conduct]: https://github.com/ipfs/community/blob/master/code-of-conduct.md