[NEW CONTENT] [BOUNTY] Glossary

[Mr0grog]

This issue has a bounty!

Successfully closing this issue by producing a production-ready piece of documentation can earn you not only the undying love of the IPFS community — it can net you a financial reward. See the current list of bounty issues and their values here.

The need in brief

Create a glossary that provides a brief and clear definition of major concepts in IPFS, plus links to longer explainers when they exist. Note that we will be pulling these definitions into hover-style tool tips in the future, so please keep definitions fairly brief and written in such a way that the first n characters can be excerpted into a complete tool tip.

Regarding future use in tool tips: Visual design work has already been done on this effort. Please see #372 for mockups and resulting discussion; it'll help you determine how best to proceed with excerpting tool-tip content.

Below are initial terms to seed with. Please add others as you see fit. See as well prior art for “concepts and terms that trip people up”.

• DWeb
• DHT
• Graph
• DAG
• Merkle Tree/DAG
• Merkle “Forest”
• Hash
• Gateway
• Pinning
• Transport
• Swarm
• Information Space
• MFS
• UnixFS (lots of confusion out there on whether this is the same or different from MFS)
• (Cryptographic) Signing
• Peer
• Peer ID
• CRDT
• Repo
• DataStore
• Node, Daemon
• CID (v0, v1, …)
• Path/Address
• DNSLink
• CBOR
• Bitswap
• Blocks
• Bootstrap Node
• Listening
• Dialing
• Announcing
• Relay
• GC/Garbage Collection
• Pubsub
• Filestore
• IPLD (and selectors)
• Libp2p
• Multihash
• IPNS
• SFS
• Blockchain
• Bittorrent
• GraphSync
• pubsub
• filestore
• IPLD
• Libp2p
• multihash
• IPNS
• SFS
• Blockchain
• Bittorrent
• IPLD Selectors
• GraphSync

Deliverable

Content should take the form of a Markdown document. File locations should be as follows:

• MD content should live here (lease make a PR against the existing placeholder document) https://github.com/ipfs/ipfs-docs-v2/blob/master/docs/concepts/glossary.md
• Images, if appropriate, can live in the MD content's parent directory; we'll move them before final merge
• For videos, just post temporarily on the platform of your choice, and we'll sort out on a case-by-case basis

Guidelines

• Please use the IPFS Docs Contributor Guidelines as your north star — adherence to these guidelines are crucial when it comes to awarding potential bounty!
• Also, please keep in mind our core user personae. If a piece of content serves one or more personae in particular, make sure it checks out with that persona's attributes.

[MichaelMure]

• pubsub
• filestore
• IPLD
• Libp2p
• multihash

[fsdiogo]

I would also add:

• IPNS
• SFS

and even

• Blockchain
• Bittorrent

But like you said, the latter could just be linked to agreed upon sources.

[Mr0grog]

Wow, I totally thought IPNS was on the list! Thanks.

[eocarragain]

Also:

• IPRS (see https://github.com/libp2p/specs/blob/master/IPRS.md and https://discuss.ipfs.io/t/confusion-about-ipns/1414)
• IPLD-Next

[eocarragain]

IPLD Selectors
GraphSync

[vmx]

@eocarragain The current documentation for IPLD Selectors and GraphSync is: "TBD", there isn't much else yet :)