multiformats / multiformats/multicodec

Options for adding docs and test fixtures for multicodec entries

Open
#240 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
383
Forks
221
Avg merge
24d 6h
Merged PRs (30d)
1

Description

In the space of a few weeks we have two separate discussion about needing a place to define entries in the multicodec table, including test fixtures:

We don’t really have such a space currently. Some options:

  • We have https://multiformats.io which is currently just a very simple static 3 page site - hasn’t been touched in a year and uses Hugo. It'll probably need some work to make it easier to hold specs and fixture data, including moving off Hugo.
  • We have https://ipld.io which is much more actively maintained and we’re shoving test fixture data into it these days too (mainly using testmark). The problem here is that even the above two entries push uncomfortably at the definitional scope of "IPLD" - do either of those really belong on an IPLD site?
  • We have this repo, which we could just add a new directory to "specs" which contains a directory for each new spec we want to add, and not worry about fancy web frontends.
  • We have https://github.com/multiformats/specs which contains some initial drafts of general multiformats IETF specs (to define multihash, multiaddr, multibase etc.) that we wanted to propose (we still need to do this but the work is a bit stale!). We could expand the scope of that repo to allow it contain arbitrary specifications for any entry in this table that doesn't have a logical home elsewhere for a specification.

At this stage I'm inclined to consider the last option - just do it in the repo, no web frontend, encourage the use of testmark for fixturing but not be too restrictive in formats or content of a "specification" initially but let that evolve over time.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the repository's existing specs area and the linked Murmur3 and RSA discussions, then compare the four possible homes described in the issue. Done would require a decided location and agreed format or process for multicodec specifications and test fixtures; the issue currently leaves that design unresolved.

Written by the indexing model from the issue text.

Assessment

Tech stack
hugo
Domain
documentation, testing
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.