Skip to content

Conversation

@hoijui
Copy link
Contributor

@hoijui hoijui commented May 7, 2025

Description

Adds links to related tech mentioned in examples/README.
This is useful to people new to the field, like me.

Notes & open questions

I am not very happy with the link for IPFS private swarm, but despite looking for 10+ min, I could not find a link that would fit better, and it is a term that laymen will unlikely understand.

@elenaf9
Copy link
Member

elenaf9 commented May 8, 2025

Thanks for the PR @hoijui.

I understand that for a user these links might be helpful, but I am a bit hesitant to link Wikipedia articles on mDNS, Kademlia, etc because a) it's Wikipedia (I'd rather link reliable sources like RFCs, papers, etc) and b) we don't always follow the "official" protocol completely, but e.g. only implement a subset of the protocol features or include some libp2p-specific changes.

So if we link anything, I think it would be best to just link the libp2p specs for each protocol. Or just add a general sentence that the details of each mentioned protocol can be found in https://github.com/libp2p/specs/.

@elenaf9 elenaf9 added the need/author-input Needs input from the original author label May 18, 2025
Copy link
Member

@jxs jxs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@jxs jxs changed the title README: Add Links to mentioned tech chore(README.md): Add Links to mentioned tech Oct 20, 2025
@jxs jxs added send-it and removed need/author-input Needs input from the original author labels Oct 20, 2025
@mergify mergify bot added the queued label Oct 20, 2025
@mergify mergify bot merged commit dd3fb5d into libp2p:master Oct 20, 2025
70 checks passed
@mergify mergify bot removed the queued label Oct 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants