Create a libp2p.io/specs website

[p-shahi]

The specs repo should be served separately similar to spec.filecoin.io

The rendered output is a nicer way to read the specifications. It matters more for casual users/new learners who are not writing/updating specs on a day to day basis.

There are existing solutions to deploy a site directly from the specs directory without needing to duplicate content or incurring maintenance overhead (aim should be zero overhead) for specs writers/maintainers.

My favorite examples are this spec site: https://internetcomputer.org/docs/current/references/ic-interface-spec/
rendered from this AsciiDoc: https://github.com/dfinity/interface-spec/blob/master/spec/index.adoc

and the Filecoin spec site https://spec.filecoin.io/

copied from: libp2p/docs#210 (comment)

@DannyS03 's notion page: https://www.notion.so/pl-strflt/libp2p-specs-site-dfec46f10d5340dc87bbf0355159f0a5

[mxinden]

@p-shahi would you mind detailing the motivation in the issue description?

[MarcoPolo]

I'm not convinced of the utility of a specs website.

The specs repo today lets users:

• See the current specs
• Comment on existing specs (either open an issue or make a PR change)
• Get notified on updates
• Track changes over time.

That said, I'm not opposed to redirecting specs.libp2p.io to this repo.