Publish existing Bitswap specs at specs.ipfs.tech

[hacdias]

As per what I discussed with @lidel, this PR moves the current Bitswap specs to the website. Merge should be done using rebase or merge commit in order to preserve the history for the Bitswap specifications.

Note that I put this under architecture. We may want to either create a new section, or put it somewhere else.

[lidel]

I've created /exchange category and moved Bitswap spec to /exchange/bitswap (which will produce permalink https://specs.ipfs.tech/exchange/bitswap/).

Preview:

• https://bafybeibutkluyz3u2cm65zftu7cxtasbrtltz5s3hapsx2wehg2uxyrl5u.on.fleek.co/
  • https://bafybeibutkluyz3u2cm65zftu7cxtasbrtltz5s3hapsx2wehg2uxyrl5u.on.fleek.co/exchange/bitswap/

@aschmahmann any concerns or ok to merge?

[aschmahmann]

Mostly LGTM, one small change requested (removing the unnecessary text after switching the section from content routing -> routing). The rest are optional.

Thanks for doing this 🙏

[aschmahmann]

Can be done in a follow up, but noticed we're missing a Rust implementation here. Anyone know what implementations of Bitswap are best supported in Rust? cc @mxinden @b5

[mxinden]

I know several, but I am not familiar enough with either to be able to endorse one.

[aschmahmann]

If there are multiple I think fine to include them.

Just would prefer to not add in abandoned, non functional, etc. implementations where people will likely be better off not relying on them. People can still find those with a search engine if they want to build an implementation and see where others left off.

[lidel]

@b5 @dignifiedquire do you feel we could include bitswap crate from Beetle here (in this PR or future one), or is it not something you plan to maintain going forward?

feedback addressed

[lidel]

@achingbrain: any learnings from maintaining https://github.com/ipfs/js-ipfs-bitswap?
@hannahhoward @gammazero @masih: I know you've been using bitswap (1.2.0?) for retrieval in Lassie and for content routing in Cassette this year.

This is the revamped spec for basics of Bitswap Protocol (it does not include things like Bitswap Sessions, which are implementation-specific).

Is there anything you feel is missing from this document? Any "Notes for implementers" we could/should include as an Appendix to this document, while we are at it?

If not, perfectly ok, just thought I'll send a ping in your direction in case there was something you've noticed.

[BigLep]

2023-10-17 maintainer conversation: @aschmahmann will approve and @lidel will merge