libp2p · salmad3 · Oct 26, 2022 · Aug 31, 2022 · Sep 1, 2022 · Sep 1, 2022
diff --git a/.DS_Store b/.DS_Store
diff --git a/config.toml b/config.toml
@@ -2,8 +2,9 @@ baseURL = "https://docs.libp2p.io"
 relativeURLs = true
 languageCode = "en-us"
 title = "libp2p Documentation"
+summaryLength = 20
 
-theme = "hugo-theme-learn"
+theme = ["hugo-theme-learn"]
 
 [params]
 themeVariant = "libp2p"
@@ -18,12 +19,19 @@ url = "https://libp2p.io"
 weight = 1
 
 [[menu.shortcuts]]
-name = "<i class='fab fa-github'></i> libp2p Github"
+name = "<i class='fab fa-github'></i> libp2p GitHub"
 url = "https://github.com/libp2p/libp2p"
 weight = 2
 
+[[menu.shortcuts]]
+name = "<i class='fab fa-github'></i> libp2p Specs"
+url = "https://github.com/libp2p/specs"
+weight = 3
+
 [[menu.shortcuts]]
 name = "<i class='fab fa-discourse'></i> Discussion Forums"
 url = "https://discuss.libp2p.io"
-weight = 3
+weight = 4
 
+[markup.goldmark.renderer]
+  unsafe = true # Allow HTML in md files
diff --git a/content/.DS_Store b/content/.DS_Store
diff --git a/content/_index.md b/content/_index.md
@@ -1,29 +1,16 @@
 ---
-title: libp2p documentation portal
+title: libp2p Documentation Portal
 menuTitle: libp2p
 weight: 1
-pre: "<b>1. </b>"
+pre: "<b> </b>"
 chapter: true
 ---
 
-# libp2p Documentation Portal
+# Welcome to the Documentation Portal
 
-Welcome to the libp2p documentation portal! Whether you’re just learning how to build peer-to-peer systems with libp2p, want to dive into peer-to-peer concepts and solutions, or are looking for detailed reference 
+Welcome to the libp2p Documentation Portal! Whether you’re just learning how to build peer-to-peer systems with 
+libp2p, want to dive into peer-to-peer concepts and solutions, or are looking for detailed reference 
 information, this is the place to start.
 
 {{% children description="true" %}}
 
-{{% notice "note" %}}
-This section is incomplete, and many of the articles are stubs. To help fill in
-the gaps, please see the issues linked in each article to add your input and
-help us prioritize the outstanding work.
-{{% /notice %}}
-
-### Related Projects
-
-libp2p began as part of the [IPFS](https://ipfs.io) project, and is still an essential component of IPFS. As such, libp2p composes well with the abstractions and tools provided by other projects in the IPFS "family". Check their individual sites for specific information and references:
-
-- [IPFS](https://ipfs.io) is the InterPlanetary File System, which uses libp2p as its networking layer.
-- [Multiformats](https://multiformats.io) is a variety of *self-describing* data formats.
-- [IPLD](https://ipld.io) is a set of tools for describing links between content-addressed data, like IPFS files, Git commits, or Ethereum blocks.
-- [The Permissive License Stack](https://protocol.ai/blog/announcing-the-permissive-license-stack) is a licensing strategy for software development that embraces open-source values.
diff --git a/content/community/_index.md b/content/community/_index.md
@@ -1,11 +1,13 @@
 ---
 title: "Community"
-weight: 10
-pre: '<i class="fas fa-fw fa-lightbulb"></i> '
+weight: 5
+pre: '<i class="fas fa-fw fa-newspaper"></i> '
+chapter: true
+summary: Get in touch with other members working on or with libp2p, learn how to contribute, and become an active participant in the libp2p community.
 ---
 
-Get in touch with other members of the libp2p community who are building tools and applications with libp2p! You can ask questions, discuss new ideas, or get support for problems at [libp2p discussion forums](https://discuss.libp2p.io/), but you can also [hop on IRC](/community/irc/) for a quick chat.
+# Get Involved with libp2p
 
-See the other links in the community section for more information about meetings, events, apps people are building, and more.
+Find out how to get involved with libp2p and join the community.
 
-Information about contributing to libp2p and about other software projects in the community are also hosted here.
+{{% children description="true"%}}
diff --git a/content/discuss/_index.md → content/community/community.md b/content/discuss/_index.md → content/community/community.md
@@ -1,9 +1,13 @@
 ---
-title: "Help & Discussion"
-weight: 100
-pre: "<i class='fas fa-fw fa-question-circle'></i> "
+title: "Get Involved"
+weight: 1
+pre: '<i class="fas fa-fw fa-book"></i> <b> </b>'
+chapter: true
+summary: Get involved and participate in the libp2p community.
 ---
 
+# Get Involved
+
 We love talking about libp2p, and we'd be happy to have you in the mix.
 
 Visit our [discussion forums](https://discuss.libp2p.io) to ask questions about [using libp2p](https://discuss.libp2p.io/c/users), discuss exciting [research](https://discuss.libp2p.io/c/research), and [stay up to date with important announcments](https://discuss.libp2p.io/c/news). 

diff --git a/content/contributing/_index.md → content/community/contribute.md b/content/contributing/_index.md → content/community/contribute.md
@@ -1,26 +1,31 @@
 ---
-title: "Get Involved"
-weight: 10
-pre: '<i class="fas fa-fw fa-heart"></i> '
+title: "How to Contribute"
+weight: 2
+pre: '<i class="fas fa-fw fa-book"></i> <b> </b>'
+chapter: true
+summary: Learn how you can contribute to libp2p.
 ---
 
+# How to Contribute
+
 So you want to contribute to libp2p and the peer-to-peer ecosystem? Here is a quick listing
 of things we need help with and how you can get started. Even if what you want
 to do is not listed here, we probably accept contributions for it! If you're
 unsure, please open a issue.
 
 ## Areas of contribution
-- [Areas of contribution](#areas-of-contribution)
-  - [Code](#code)
-  - [Documentation](#documentation)
-  - [Support](#support)
-  - [Testing](#testing)
-  - [Design](#design)
-  - [Issues / Triaging](#issues--triaging)
-  - [Community](#community)
-  - [Applications](#applications)
-  - [Protocol Design](#protocol-design)
-  - [Research](#research)
+- [How to Contribute](#how-to-contribute)
+  - [Areas of contribution](#areas-of-contribution)
+    - [Code](#code)
+    - [Documentation](#documentation)
+    - [Support](#support)
+    - [Testing](#testing)
+    - [Design](#design)
+    - [Issues / Triaging](#issues--triaging)
+    - [Community](#community)
+    - [Applications](#applications)
+    - [Protocol Design](#protocol-design)
+    - [Research](#research)
 
 ### Code
 

diff --git a/content/concepts/_index.md b/content/concepts/_index.md
@@ -1,16 +1,15 @@
 ---
-title: "Core Components"
+title: Core Components
 weight: 2
-pre: '<i class="fas fa-fw fa-lightbulb"></i> '
+pre: '<i class="fas fa-fw fa-clone"></i> '
+chapter: true
+aliases: /reference/specs/
+summary: libp2p covers a lot of ground, and may involve unfamiliar terminology and concepts. This section goes over the foundational concepts involved in libp2p.
 ---
 
-libp2p covers a lot of ground, and may involve unfamiliar terminology and concepts.
-This section goes over the foundational concepts involved in libp2p.
+# Learn about libp2p
 
-{{% children %}}
+libp2p covers a lot of ground, and may involve unfamiliar terminology and concepts.
+This chapter goes over the foundational concepts involved in libp2p.
 
-{{% notice "note" %}}
-This section is incomplete, and many of the articles are stubs. To help fill in
-the gaps, please see the issues linked in each article to add your input and
-help us prioritize the outstanding work.
-{{% /notice %}}
+{{% children description="true"%}}
diff --git a/...cepts/publish-subscribe/fanout_forget.png → ...ssets/publish-subscribe/fanout_forget.png b/...cepts/publish-subscribe/fanout_forget.png → ...ssets/publish-subscribe/fanout_forget.png
diff --git a/...cepts/publish-subscribe/fanout_forget.svg → ...ssets/publish-subscribe/fanout_forget.svg b/...cepts/publish-subscribe/fanout_forget.svg → ...ssets/publish-subscribe/fanout_forget.svg
diff --git a/...-subscribe/fanout_grafting_preference.png → ...-subscribe/fanout_grafting_preference.png b/...-subscribe/fanout_grafting_preference.png → ...-subscribe/fanout_grafting_preference.png
diff --git a/...-subscribe/fanout_grafting_preference.svg → ...-subscribe/fanout_grafting_preference.svg b/...-subscribe/fanout_grafting_preference.svg → ...-subscribe/fanout_grafting_preference.svg
diff --git a/...publish-subscribe/fanout_initial_pick.png → ...publish-subscribe/fanout_initial_pick.png b/...publish-subscribe/fanout_initial_pick.png → ...publish-subscribe/fanout_initial_pick.png
diff --git a/...publish-subscribe/fanout_initial_pick.svg → ...publish-subscribe/fanout_initial_pick.svg b/...publish-subscribe/fanout_initial_pick.svg → ...publish-subscribe/fanout_initial_pick.svg
diff --git a/...publish-subscribe/fanout_message_send.png → ...publish-subscribe/fanout_message_send.png b/...publish-subscribe/fanout_message_send.png → ...publish-subscribe/fanout_message_send.png
diff --git a/...publish-subscribe/fanout_message_send.svg → ...publish-subscribe/fanout_message_send.svg b/...publish-subscribe/fanout_message_send.svg → ...publish-subscribe/fanout_message_send.svg
diff --git a/...ublish-subscribe/full_message_forward.png → ...ublish-subscribe/full_message_forward.png b/...ublish-subscribe/full_message_forward.png → ...ublish-subscribe/full_message_forward.png
diff --git a/...ublish-subscribe/full_message_forward.svg → ...ublish-subscribe/full_message_forward.svg b/...ublish-subscribe/full_message_forward.svg → ...ublish-subscribe/full_message_forward.svg
diff --git a/...ublish-subscribe/full_message_network.png → ...ublish-subscribe/full_message_network.png b/...ublish-subscribe/full_message_network.png → ...ublish-subscribe/full_message_network.png
diff --git a/...ublish-subscribe/full_message_network.svg → ...ublish-subscribe/full_message_network.svg b/...ublish-subscribe/full_message_network.svg → ...ublish-subscribe/full_message_network.svg
diff --git a/...s/publish-subscribe/full_message_send.png → ...s/publish-subscribe/full_message_send.png b/...s/publish-subscribe/full_message_send.png → ...s/publish-subscribe/full_message_send.png
diff --git a/...s/publish-subscribe/full_message_send.svg → ...s/publish-subscribe/full_message_send.svg b/...s/publish-subscribe/full_message_send.svg → ...s/publish-subscribe/full_message_send.svg
diff --git a/...epts/publish-subscribe/gossip_deliver.png → ...sets/publish-subscribe/gossip_deliver.png b/...epts/publish-subscribe/gossip_deliver.png → ...sets/publish-subscribe/gossip_deliver.png
diff --git a/...epts/publish-subscribe/gossip_deliver.svg → ...sets/publish-subscribe/gossip_deliver.svg b/...epts/publish-subscribe/gossip_deliver.svg → ...sets/publish-subscribe/gossip_deliver.svg
diff --git a/...oncepts/publish-subscribe/graft_prune.png → .../assets/publish-subscribe/graft_prune.png b/...oncepts/publish-subscribe/graft_prune.png → .../assets/publish-subscribe/graft_prune.png
diff --git a/...oncepts/publish-subscribe/graft_prune.svg → .../assets/publish-subscribe/graft_prune.svg b/...oncepts/publish-subscribe/graft_prune.svg → .../assets/publish-subscribe/graft_prune.svg
diff --git a/...epts/publish-subscribe/maintain_graft.png → ...sets/publish-subscribe/maintain_graft.png b/...epts/publish-subscribe/maintain_graft.png → ...sets/publish-subscribe/maintain_graft.png
diff --git a/...epts/publish-subscribe/maintain_graft.svg → ...sets/publish-subscribe/maintain_graft.svg b/...epts/publish-subscribe/maintain_graft.svg → ...sets/publish-subscribe/maintain_graft.svg
diff --git a/...epts/publish-subscribe/maintain_prune.png → ...sets/publish-subscribe/maintain_prune.png b/...epts/publish-subscribe/maintain_prune.png → ...sets/publish-subscribe/maintain_prune.png
diff --git a/...epts/publish-subscribe/maintain_prune.svg → ...sets/publish-subscribe/maintain_prune.svg b/...epts/publish-subscribe/maintain_prune.svg → ...sets/publish-subscribe/maintain_prune.svg
diff --git a/...sh-subscribe/message_delivered_to_all.png → ...sh-subscribe/message_delivered_to_all.png b/...sh-subscribe/message_delivered_to_all.png → ...sh-subscribe/message_delivered_to_all.png
diff --git a/...sh-subscribe/message_delivered_to_all.svg → ...sh-subscribe/message_delivered_to_all.svg b/...sh-subscribe/message_delivered_to_all.svg → ...sh-subscribe/message_delivered_to_all.svg
diff --git a/...blish-subscribe/metadata_only_network.png → ...blish-subscribe/metadata_only_network.png b/...blish-subscribe/metadata_only_network.png → ...blish-subscribe/metadata_only_network.png
diff --git a/...blish-subscribe/metadata_only_network.svg → ...blish-subscribe/metadata_only_network.svg b/...blish-subscribe/metadata_only_network.svg → ...blish-subscribe/metadata_only_network.svg
diff --git a/...sh-subscribe/network_packet_structure.png → ...sh-subscribe/network_packet_structure.png b/...sh-subscribe/network_packet_structure.png → ...sh-subscribe/network_packet_structure.png
diff --git a/...sh-subscribe/network_packet_structure.svg → ...sh-subscribe/network_packet_structure.svg b/...sh-subscribe/network_packet_structure.svg → ...sh-subscribe/network_packet_structure.svg
diff --git a/...sh-subscribe/request_gossiped_message.png → ...sh-subscribe/request_gossiped_message.png b/...sh-subscribe/request_gossiped_message.png → ...sh-subscribe/request_gossiped_message.png
diff --git a/...sh-subscribe/request_gossiped_message.svg → ...sh-subscribe/request_gossiped_message.svg b/...sh-subscribe/request_gossiped_message.svg → ...sh-subscribe/request_gossiped_message.svg
diff --git a/content/concepts/publish-subscribe/state.png → ...ncepts/assets/publish-subscribe/state.png b/content/concepts/publish-subscribe/state.png → ...ncepts/assets/publish-subscribe/state.png
diff --git a/content/concepts/publish-subscribe/state.svg → ...ncepts/assets/publish-subscribe/state.svg b/content/concepts/publish-subscribe/state.svg → ...ncepts/assets/publish-subscribe/state.svg
diff --git a/...pts/publish-subscribe/subscribe_graft.png → ...ets/publish-subscribe/subscribe_graft.png b/...pts/publish-subscribe/subscribe_graft.png → ...ets/publish-subscribe/subscribe_graft.png
diff --git a/...pts/publish-subscribe/subscribe_graft.svg → ...ets/publish-subscribe/subscribe_graft.svg b/...pts/publish-subscribe/subscribe_graft.svg → ...ets/publish-subscribe/subscribe_graft.svg
diff --git a/...ts/publish-subscribe/subscribed_peers.png → ...ts/publish-subscribe/subscribed_peers.png b/...ts/publish-subscribe/subscribed_peers.png → ...ts/publish-subscribe/subscribed_peers.png
diff --git a/...ts/publish-subscribe/subscribed_peers.svg → ...ts/publish-subscribe/subscribed_peers.svg b/...ts/publish-subscribe/subscribed_peers.svg → ...ts/publish-subscribe/subscribed_peers.svg
diff --git a/...sh-subscribe/subscription_list_change.png → ...sh-subscribe/subscription_list_change.png b/...sh-subscribe/subscription_list_change.png → ...sh-subscribe/subscription_list_change.png
diff --git a/...sh-subscribe/subscription_list_change.svg → ...sh-subscribe/subscription_list_change.svg b/...sh-subscribe/subscription_list_change.svg → ...sh-subscribe/subscription_list_change.svg
diff --git a/...cribe/subscription_list_first_connect.png → ...cribe/subscription_list_first_connect.png b/...cribe/subscription_list_first_connect.png → ...cribe/subscription_list_first_connect.png
diff --git a/...cribe/subscription_list_first_connect.svg → ...cribe/subscription_list_first_connect.svg b/...cribe/subscription_list_first_connect.svg → ...cribe/subscription_list_first_connect.svg
diff --git a/...sh-subscribe/subscriptions_local_view.png → ...sh-subscribe/subscriptions_local_view.png b/...sh-subscribe/subscriptions_local_view.png → ...sh-subscribe/subscriptions_local_view.png
diff --git a/...sh-subscribe/subscriptions_local_view.svg → ...sh-subscribe/subscriptions_local_view.svg b/...sh-subscribe/subscriptions_local_view.svg → ...sh-subscribe/subscriptions_local_view.svg
diff --git a/...ts/publish-subscribe/types_of_peering.png → ...ts/publish-subscribe/types_of_peering.png b/...ts/publish-subscribe/types_of_peering.png → ...ts/publish-subscribe/types_of_peering.png
diff --git a/...ts/publish-subscribe/types_of_peering.svg → ...ts/publish-subscribe/types_of_peering.svg b/...ts/publish-subscribe/types_of_peering.svg → ...ts/publish-subscribe/types_of_peering.svg
diff --git a/...s/publish-subscribe/unsubscribe_prune.png → ...s/publish-subscribe/unsubscribe_prune.png b/...s/publish-subscribe/unsubscribe_prune.png → ...s/publish-subscribe/unsubscribe_prune.png
diff --git a/...s/publish-subscribe/unsubscribe_prune.svg → ...s/publish-subscribe/unsubscribe_prune.svg b/...s/publish-subscribe/unsubscribe_prune.svg → ...s/publish-subscribe/unsubscribe_prune.svg
diff --git a/content/concepts/content-routing.md b/content/concepts/content-routing.md