zio · jdegoes · Jul 23, 2022 · Jul 21, 2022 · Jul 21, 2022 · Jul 22, 2022
diff --git a/docs/guides/index.md b/docs/guides/index.md
@@ -12,9 +12,6 @@ The following guides have been written to help you get started with ZIO with min
 2. [ZIO Quickstart: Building a RESTful Web Service](quickstarts/restful-webservice.md)
 3. [ZIO Quickstart: Building a GraphQL Web Service](quickstarts/graphql-webservice.md)
 4. [ZIO Quickstart: Building a gRPC Server and Client](https://scalapb.github.io/zio-grpc/docs/quickstart/)
-5. Getting Started With ZIO Streaming
-6. Getting Started With ZIO and ScalaJS
-7. Getting Started with a ZIO Application With a Persistent Layer
 
 ## Tutorial Guides
 
@@ -29,13 +26,6 @@ The following guides have been written to help you get started with ZIO with min
 9. [How to Monitor a ZIO Application Using ZIO's Built-in Metric System?](tutorials/monitor-a-zio-application-using-zios-built-in-metric-system.md)
 10. [How to Produce/Consume Data To/From Kafka Topics?](tutorials/produce-consume-data-to-from-kafka-topics.md)
 11. [How to Debug a ZIO Application?](tutorials/debug-a-zio-application.md)
-12. Building a Web Service Client
-13. Building a gRPC Service with its Client
-14. How to Build a Chat Client and Server using ZIO Streams?
-15. How to Monitor a ZIO Application by Implementing Custom Metrics
-16. How to Integrate ZIO With a Legacy JVM Application?
-17. How to Consume/Produce Data From/To a RabbitMQ Queue?
-18. How to Enable Tracing in ZIO and How to Use it?
 
 ## Integration Guides
 

diff --git a/docs/guides/migrate/from-cats-effect.md b/docs/guides/migrate/from-cats-effect.md
@@ -1,6 +1,7 @@
 ---
 id: from-cats-effect
 title: "How to Migrate from Cats Effect to ZIO?"
+sidebar_label: "Migration from Cats Effect"
 ---
 
 Cats `IO[A]` can be easily replaced with ZIO's `Task[A]` (an alias for `ZIO[Any, Throwable, A]`).

diff --git a/docs/guides/migrate/from-monix.md b/docs/guides/migrate/from-monix.md
@@ -1,6 +1,7 @@
 ---
 id: from-monix
 title: "How to Migrate from Monix to ZIO?"
+sidebar_label: "Migration from Monix"
 ---
 
 Monix's `Task[A]` can be easily replaced with ZIO's `Task[A]` (an alias for `ZIO[Any, Throwable, A]`).

diff --git a/docs/guides/migrate/migration-guide.md b/docs/guides/migrate/migration-guide.md
@@ -2623,7 +2623,7 @@ for {
 } yield ()
 ```
 
-Visit the [Hub](../../references/concurrency/hub) page to learn more about it.
+Visit the [Hub](../../reference/concurrency/hub) page to learn more about it.
 
 ### ZIO Aspects
 

diff --git a/docs/guides/tutorials/produce-consume-data-to-from-kafka-topics.md b/docs/guides/tutorials/produce-consume-data-to-from-kafka-topics.md
@@ -43,7 +43,7 @@ libraryDependencies += Seq(
 
 1. **ZIO Kafka** is a ZIO native client for Apache Kafka. It has a high-level streaming API on top of the Java client. So we can produce and consume events using the declarative concurrency model of ZIO Streams.
 
-2. **ZIO Stream** introduces a high-level API for working with streams of values. It is designated to work in a highly concurrent environment. It has seamless integration with ZIO, so we have the ability to use all the features of the ZIO along with the streams, e.g. `Scope`, `Schedule`, `ZLayer`, `Quque`, `Hub` etc. To learn more about ZIO Stream, we have a comprehensive section in on that [here](../../references/stream/index.md).
+2. **ZIO Stream** introduces a high-level API for working with streams of values. It is designated to work in a highly concurrent environment. It has seamless integration with ZIO, so we have the ability to use all the features of the ZIO along with the streams, e.g. `Scope`, `Schedule`, `ZLayer`, `Quque`, `Hub` etc. To learn more about ZIO Stream, we have a comprehensive section in on that [here](../../reference/stream/index.md).
 
 3. **ZIO JSON** is a library to serialize and deserialize data from/to JSON data type. We will be using this library to serialize and deserialize data when reading and writing JSON data from/to Kafka topics.
 

diff --git a/docs/overview/handling_errors.md b/docs/overview/handling_errors.md
@@ -135,7 +135,7 @@ val retryOpenFile: ZIO[Any, IOException, DefaultData) =
       .retryOrElse(Schedule.recurs(5), (_, _) => ZIO.succeed(DefaultData))
 ```
 
-For more information on how to build schedules, see the documentation on [Schedule](../references/misc/schedule.md).
+For more information on how to build schedules, see the documentation on [Schedule](../reference/misc/schedule.md).
 
 ## Next Steps
 

diff --git a/docs/references/concurrency/hub.md → docs/reference/concurrency/hub.md b/docs/references/concurrency/hub.md → docs/reference/concurrency/hub.md
diff --git a/docs/references/concurrency/index.md → docs/reference/concurrency/index.md b/docs/references/concurrency/index.md → docs/reference/concurrency/index.md
diff --git a/docs/references/concurrency/promise.md → docs/reference/concurrency/promise.md b/docs/references/concurrency/promise.md → docs/reference/concurrency/promise.md
diff --git a/docs/references/concurrency/queue.md → docs/reference/concurrency/queue.md b/docs/references/concurrency/queue.md → docs/reference/concurrency/queue.md
diff --git a/docs/references/concurrency/ref.md → docs/ F438 reference/concurrency/ref.md b/docs/references/concurrency/ref.md → docs/ F438 reference/concurrency/ref.md
diff --git a/...references/concurrency/refsynchronized.md → .../reference/concurrency/refsynchronized.md b/...references/concurrency/refsynchronized.md → .../reference/concurrency/refsynchronized.md
diff --git a/docs/references/concurrency/semaphore.md → docs/reference/concurrency/semaphore.md b/docs/references/concurrency/semaphore.md → docs/reference/concurrency/semaphore.md
diff --git a/docs/references/contextual/index.md → docs/reference/contextual/index.md b/docs/references/contextual/index.md → docs/reference/contextual/index.md
diff --git a/docs/references/contextual/layer.md → docs/reference/contextual/layer.md b/docs/references/contextual/layer.md → docs/reference/contextual/layer.md
diff --git a/docs/references/contextual/rlayer.md → docs/reference/contextual/rlayer.md b/docs/references/contextual/rlayer.md → docs/reference/contextual/rlayer.md
diff --git a/docs/references/contextual/services/clock.md → docs/reference/contextual/services/clock.md b/docs/references/contextual/services/clock.md → docs/reference/contextual/services/clock.md
diff --git a/...references/contextual/services/console.md → .../reference/contextual/services/console.md b/...references/contextual/services/console.md → .../reference/contextual/services/console.md
diff --git a/docs/references/contextual/services/index.md → docs/reference/contextual/services/index.md b/docs/references/contextual/services/index.md → docs/reference/contextual/services/index.md
diff --git a/.../references/contextual/services/random.md → docs/reference/contextual/services/random.md b/.../references/contextual/services/random.md → docs/reference/contextual/services/random.md
diff --git a/.../references/contextual/services/system.md → docs/reference/contextual/services/system.md b/.../references/contextual/services/system.md → docs/reference/contextual/services/system.md
diff --git a/docs/references/contextual/task-layer.md → docs/reference/contextual/task-layer.md b/docs/references/contextual/task-layer.md → docs/reference/contextual/task-layer.md
diff --git a/docs/references/contextual/ulayer.md → docs/reference/contextual/ulayer.md b/docs/references/contextual/ulayer.md → docs/reference/contextual/ulayer.md
diff --git a/docs/references/contextual/urlayer.md → docs/reference/contextual/urlayer.md b/docs/references/contextual/urlayer.md → docs/reference/contextual/urlayer.md
diff --git a/docs/references/contextual/zenvironment.md → docs/reference/contextual/zenvironment.md b/docs/references/contextual/zenvironment.md → docs/reference/contextual/zenvironment.md
diff --git a/docs/references/contextual/zlayer.md → docs/reference/contextual/zlayer.md b/docs/references/contextual/zlayer.md → docs/reference/contextual/zlayer.md
diff --git a/docs/references/core/cause.md → docs/reference/core/cause.md b/docs/references/core/cause.md → docs/reference/core/cause.md
diff --git a/docs/references/core/exit.md → docs/reference/core/exit.md b/docs/references/core/exit.md → docs/reference/core/exit.md
diff --git a/docs/reference/core/index.md b/docs/reference/core/index.md
@@ -0,0 +1,17 @@
+---
+id: index
+title: "Core Data Types"
+---
+
+In this section we are going to talk about the basic data types that are required to build a ZIO application:
+
+- **[ZIO](zio/zio.md)** — `ZIO` is a value that models an effectful program, which might fail or succeed.
+    + **[UIO](zio/uio.md)** — `UIO[A]` is a type alias for `ZIO[Any, Nothing, A]`.
+    + **[URIO](zio/urio.md)** — `URIO[R, A]` is a type alias for `ZIO[R, Nothing, A]`.
+    + **[Task](zio/task.md)** — `Task[A]` is a type alias for `ZIO[Any, Throwable, A]`.
+    + **[RIO](zio/rio.md)** — `RIO[R, A]` is a type alias for `ZIO[R, Throwable, A]`.
+    + **[IO](zio/io.md)** — `IO[E, A]` is a type alias for `ZIO[Any, E, A]`.
+- **[ZIOApp](zioapp.md)** — `ZIOApp` and the `ZIOAppDefault` are entry points for ZIO applications.
+- **[Runtime](runtime.md)** — `Runtime[R]` is capable of executing tasks within an environment `R`.
+- **[Exit](exit.md)** — `Exit[E, A]` describes the result of executing an `IO` value.
+- **[Cause](cause.md)** — `Cause[E]` is a description of a full story of a fiber failure.
diff --git a/docs/references/core/runtime.md → docs/reference/core/runtime.md b/docs/references/core/runtime.md → docs/reference/core/runtime.md
diff --git a/docs/references/core/zio/error-management.md → docs/reference/core/zio/error-management.md b/docs/references/core/zio/error-management.md → docs/reference/core/zio/error-management.md
diff --git a/docs/references/core/zio/io.md → docs/reference/core/zio/io.md b/docs/references/core/zio/io.md → docs/reference/core/zio/io.md
diff --git a/docs/references/core/zio/rio.md → docs/reference/core/zio/rio.md b/docs/references/core/zio/rio.md → docs/reference/core/zio/rio.md
diff --git a/docs/references/core/zio/task.md → docs/reference/core/zio/task.md b/docs/references/core/zio/task.md → docs/reference/core/zio/task.md
diff --git a/docs/references/core/zio/uio.md → docs/reference/core/zio/uio.md b/docs/references/core/zio/uio.md → docs/reference/core/zio/uio.md
diff --git a/docs/references/core/zio/urio.md → docs/reference/core/zio/urio.md b/docs/references/core/zio/urio.md → docs/reference/core/zio/urio.md
diff --git a/docs/references/core/zio/zio.md → docs/reference/core/zio/zio.md b/docs/references/core/zio/zio.md → docs/reference/core/zio/zio.md
diff --git a/docs/references/core/zioapp.md → docs/reference/core/zioapp.md b/docs/references/core/zioapp.md → docs/reference/core/zioapp.md
diff --git a/docs/references/fiber/fiber.md → docs/reference/fiber/fiber.md b/docs/references/fiber/fiber.md → docs/reference/fiber/fiber.md
diff --git a/docs/references/fiber/fiberid.md → docs/reference/fiber/fiberid.md b/docs/references/fiber/fiberid.md → docs/reference/fiber/fiberid.md
diff --git a/docs/references/fiber/fiberref.md → docs/reference/fiber/fiberref.md b/docs/references/fiber/fiberref.md → docs/reference/fiber/fiberref.md
diff --git a/docs/references/fiber/fiberstatus.md → docs/reference/fiber/fiberstatus.md b/docs/references/fiber/fiberstatus.md → docs/reference/fiber/fiberstatus.md
diff --git a/docs/references/fiber/index.md → docs/reference/fiber/index.md b/docs/references/fiber/index.md → docs/reference/fiber/index.md
diff --git a/docs/references/index.md → docs/reference/index.md b/docs/references/index.md → docs/reference/index.md
diff --git a/docs/references/metrics/counter.md → docs/reference/metrics/counter.md b/docs/references/metrics/counter.md → docs/reference/metrics/counter.md
diff --git a/docs/references/metrics/gauge.md → docs/reference/metrics/gauge.md b/docs/references/metrics/gauge.md → docs/reference/metrics/gauge.md
diff --git a/docs/references/metrics/histogram.md → docs/reference/metrics/histogram.md b/docs/references/metrics/histogram.md → docs/reference/metrics/histogram.md
diff --git a/docs/references/metrics/index.md → docs/reference/metrics/index.md b/docs/references/metrics/index.md → docs/reference/metrics/index.md
diff --git a/docs/references/metrics/jvm.md → docs/reference/metrics/jvm.md b/docs/references/metrics/jvm.md → docs/reference/metrics/jvm.md
diff --git a/docs/references/metrics/metriclabel.md → docs/reference/metrics/metriclabel.md b/docs/references/metrics/metriclabel.md → docs/reference/metrics/metriclabel.md
diff --git a/docs/references/metrics/setcount.md → docs/reference/metrics/setcount.md b/docs/references/metrics/setcount.md → docs/reference/metrics/setcount.md
diff --git a/docs/references/metrics/summary.md → docs/reference/metrics/summary.md b/docs/references/metrics/summary.md → docs/reference/metrics/summary.md
diff --git a/docs/references/misc/chunk.md → docs/reference/misc/chunk.md b/docs/references/misc/chunk.md → docs/reference/misc/chunk.md
diff --git a/docs/references/misc/schedule.md → docs/reference/misc/schedule.md b/docs/references/misc/schedule.md → docs/reference/misc/schedule.md
diff --git a/docs/references/misc/supervisor.md → docs/reference/misc/supervisor.md b/docs/references/misc/supervisor.md → docs/reference/misc/supervisor.md
diff --git a/docs/references/misc/zstate.md → docs/reference/misc/zstate.md b/docs/references/misc/zstate.md → docs/reference/misc/zstate.md
diff --git a/docs/references/resource/index.md → docs/reference/resource/index.md b/docs/references/resource/index.md → docs/reference/resource/index.md
diff --git a/docs/references/resource/scope.md → docs/reference/resource/scope.md b/docs/references/resource/scope.md → docs/reference/resource/scope.md
diff --git a/docs/references/resource/zpool.md → docs/reference/resource/zpool.md b/docs/references/resource/zpool.md → docs/reference/resource/zpool.md
diff --git a/docs/references/stm/index.md → docs/reference/stm/index.md b/docs/references/stm/index.md → docs/reference/stm/index.md
diff --git a/docs/references/stm/stm.md → docs/reference/stm/stm.md b/docs/references/stm/stm.md → docs/reference/stm/stm.md
diff --git a/docs/references/stm/tarray.md → docs/reference/stm/tarray.md b/docs/references/stm/tarray.md → docs/reference/stm/tarray.md
diff --git a/docs/references/stm/thub.md → docs/reference/stm/thub.md b/docs/references/stm/thub.md → docs/reference/stm/thub.md
diff --git a/docs/references/stm/tmap.md → docs/reference/stm/tmap.md b/docs/references/stm/tmap.md → docs/reference/stm/tmap.md
diff --git a/docs/references/stm/tpriorityqueue.md → docs/reference/stm/tpriorityqueue.md b/docs/references/stm/tpriorityqueue.md → docs/reference/stm/tpriorityqueue.md
diff --git a/docs/references/stm/tpromise.md → docs/reference/stm/tpromise.md b/docs/references/stm/tpromise.md → docs/reference/stm/tpromise.md
diff --git a/docs/references/stm/tqueue.md → docs/reference/stm/tqueue.md b/docs/references/stm/tqueue.md → docs/reference/stm/tqueue.md
diff --git a/docs/references/stm/trandom.md → docs/reference/stm/trandom.md b/docs/references/stm/trandom.md → docs/reference/stm/trandom.md
diff --git a/docs/references/stm/treentrantlock.md → docs/reference/stm/treentrantlock.md b/docs/references/stm/treentrantlock.md → docs/reference/stm/treentrantlock.md
diff --git a/docs/references/stm/tref.md → docs/reference/stm/tref.md b/docs/references/stm/tref.md → docs/reference/stm/tref.md
diff --git a/docs/references/stm/tsemaphore.md → docs/reference/stm/tsemaphore.md b/docs/references/stm/tsemaphore.md → docs/reference/stm/tsemaphore.md
diff --git a/docs/references/stm/tset.md → docs/reference/stm/tset.md b/docs/references/stm/tset.md → docs/reference/stm/tset.md
diff --git a/docs/references/stream/index.md → docs/reference/stream/index.md b/docs/references/stream/index.md → docs/reference/stream/index.md
@@ -12,8 +12,6 @@ import zio.Console._
 import java.io.IOException
 ```
 
-## Introduction
-
 The primary goal of a streaming library is to introduce **a high-level API that abstracts the mechanism of reading and writing operations using data sources and destinations**.
 
 A streaming library helps us to concentrate on the business logic and separates us from low-level implementation details.

diff --git a/docs/references/stream/sink.md → docs/reference/stream/sink.md b/docs/references/stream/sink.md → docs/reference/stream/sink.md
diff --git a/docs/references/stream/stream.md → docs/reference/stream/stream.md b/docs/references/stream/stream.md → docs/reference/stream/stream.md
diff --git a/docs/references/stream/subscriptionref.md → docs/reference/stream/subscriptionref.md b/docs/references/stream/subscriptionref.md → docs/reference/stream/subscriptionref.md
diff --git a/docs/references/stream/ustream.md → docs/reference/stream/ustream.md b/docs/references/stream/ustream.md → docs/reference/stream/ustream.md
diff --git a/docs/references/stream/zchannel.md → docs/reference/stream/zchannel.md b/docs/references/stream/zchannel.md → docs/reference/stream/zchannel.md
diff --git a/docs/references/stream/zpipeline.md → docs/reference/stream/zpipeline.md b/docs/references/stream/zpipeline.md → docs/reference/stream/zpipeline.md
diff --git a/docs/references/stream/zsink.md → docs/reference/stream/zsink.md b/docs/references/stream/zsink.md → docs/reference/stream/zsink.md
diff --git a/docs/references/stream/zstream.md → docs/reference/stream/zstream.md b/docs/references/stream/zstream.md → docs/reference/stream/zstream.md
diff --git a/docs/references/sync/concurrentmap.md → docs/reference/sync/concurrentmap.md b/docs/references/sync/concurrentmap.md → docs/reference/sync/concurrentmap.md
diff --git a/docs/references/sync/concurrentset.md → docs/reference/sync/concurrentset.md b/docs/references/sync/concurrentset.md → docs/reference/sync/concurrentset.md
diff --git a/docs/references/sync/countdownlatch.md → docs/reference/sync/countdownlatch.md b/docs/references/sync/countdownlatch.md → docs/reference/sync/countdownlatch.md
diff --git a/docs/references/sync/cyclicbarrier.md → docs/reference/sync/cyclicbarrier.md b/docs/references/sync/cyclicbarrier.md → docs/reference/sync/cyclicbarrier.md
diff --git a/docs/references/sync/index.md → docs/reference/sync/index.md b/docs/references/sync/index.md → docs/reference/sync/index.md
diff --git a/docs/references/sync/mvar.md → docs/reference/sync/mvar.md b/docs/references/sync/mvar.md → docs/reference/sync/mvar.md
diff --git a/docs/references/sync/reentrantlock.md → docs/reference/sync/reentrantlock.md b/docs/references/sync/reentrantlock.md → docs/reference/sync/reentrantlock.md
diff --git a/docs/references/test/assertion.md → docs/reference/test/assertion.md b/docs/references/test/assertion.md → docs/reference/test/assertion.md
diff --git a/docs/references/test/environment/clock.md → docs/reference/test/environment/clock.md b/docs/references/test/environment/clock.md → docs/reference/test/environment/clock.md
diff --git a/docs/references/test/environment/console.md → docs/reference/test/environment/console.md b/docs/references/test/environment/console.md → docs/reference/test/environment/console.md
diff --git a/docs/references/test/environment/index.md → docs/reference/test/environment/index.md b/docs/references/test/environment/index.md → docs/reference/test/environment/index.md
diff --git a/docs/references/test/environment/live.md → docs/reference/test/environment/live.md b/docs/references/test/environment/live.md → docs/reference/test/environment/live.md
diff --git a/docs/references/test/environment/random.md → docs/reference/test/environment/random.md b/docs/references/test/environment/random.md → docs/reference/test/environment/random.md
diff --git a/docs/references/test/environment/sized.md → docs/reference/test/environment/sized.md b/docs/references/test/environment/sized.md → docs/reference/test/environment/sized.md
diff --git a/docs/references/test/environment/system.md → docs/reference/test/environment/system.md b/docs/references/test/environment/system.md → docs/reference/test/environment/system.md
diff --git a/...eferences/test/environment/test-config.md → ...reference/test/environment/test-config.md b/...eferences/test/environment/test-config.md → ...reference/test/environment/test-config.md
diff --git a/docs/references/test/gen.md → docs/reference/test/gen.md b/docs/references/test/gen.md → docs/reference/test/gen.md
diff --git a/docs/references/test/index.md → docs/reference/test/index.md b/docs/references/test/index.md → docs/reference/test/index.md
diff --git a/docs/references/test/spec.md → docs/reference/test/spec.md b/docs/references/test/spec.md → docs/reference/test/spec.md
diff --git a/docs/references/test/test-aspect.md → docs/reference/test/test-aspect.md b/docs/references/test/test-aspect.md → docs/reference/test/test-aspect.md
diff --git a/docs/resources/ecosystem/officials/zio-mock.md b/docs/resources/ecosystem/officials/zio-mock.md
@@ -650,7 +650,7 @@ We can find more examples in the `examples` and `test-tests` subproject:
 - [ComposedEmptyMockSpec][link-gh-composed-empty-mock-spec]
 - [PolyMockSpec][link-gh-poly-mock-spec]
 
-[doc-contextual-types]: ../../../references/contextual/index.md
+[doc-contextual-types]: ../../../reference/contextual/index.md
 [link-sls-6.26.1]: https://scala-lang.org/files/archive/spec/2.13/06-expressions.html#value-conversions
 [link-test-doubles]: https://martinfowler.com/articles/mocksArentStubs.html
 [link-gh-mock-example-spec]: https://github.com/zio/zio/blob/master/examples/shared/src/test/scala/zio/examples/test/MockExampleSpec.scala

diff --git a/docs/resources/ecosystem/tools.md b/docs/resources/ecosystem/tools.md
@@ -1,6 +1,6 @@
 ---
 id: tools
-title:  "Tools for ZIO"
+title:  "ZIO Tools"
 ---
 
 - [ZIO IntelliJ](https://github.com/zio/zio-intellij) — A complimentary, community-developed plugin for IntelliJ IDEA, brings enhancements when using ZIO in your projects

diff --git a/docs/resources/index.md b/docs/resources/index.md
@@ -3,4 +3,84 @@ id: index
 title:  "Summary"
 ---
 
-If you find a new great library, talk, resource, slides or project, related to ZIO, consider adding to the list with your PR
+ZIO has a huge ecosystem of libraries, tools, talks, tutorials, and more. In this section, we are going to introduce some of the most important ones.
+
+> **Note:**
+>
+> If you find a new great library, talk, resource, slides, or project, related to ZIO, consider adding it to the list with your PR.
+
+## Learning ZIO
+
+* [Articles](learning/articles.md)
+* [Videos](learning/videos.md)
+* [Cookbooks](learning/cookbooks.md)
+* [Cheat Sheets](learning/cheatsheets.md)
+* [Sample Projects](learning/sampleprojects.md)
+* [Projects Using ZIO](learning/projectsusingzio.md)
+
+## ZIO Ecosystem
+
+We have two categories of libraries: official and community.
+
+### Official Libraries
+
+Official libraries are maintained by the ZIO team under the [ZIO Organization](https://github.com/zio).
+
+* [ZIO Actors](ecosystem/officials/zio-actors.md)
+* [ZIO Akka Cluster](ecosystem/officials/zio-akka-cluster.md)
+* [ZIO AWS](ecosystem/officials/zio-aws.md)
+* [ZIO Cache](ecosystem/officials/zio-cache.md)
+* [ZIO Config](ecosystem/officials/zio-config.md)
+* [ZIO FTP](ecosystem/officials/zio-ftp.md)
+* [ZIO JSON](ecosystem/officials/zio-json.md)
+* [ZIO Kafka](ecosystem/officials/zio-kafka.md)
+* [ZIO Logging](ecosystem/officials/zio-logging.md)
+* [ZIO Metrics](ecosystem/officials/zio-metrics.md)
+* [ZIO Mock](ecosystem/officials/zio-mock.md)
+* [ZIO NIO](ecosystem/officials/zio-nio.md)
+* [ZIO Optics](ecosystem/officials/zio-optics.md)
+* [ZIO Prelude](ecosystem/officials/zio-prelude.md)
+* [ZIO Process](ecosystem/officials/zio-process.md)
+* [ZIO Query](ecosystem/officials/zio-query.md)
+* [ZIO Redis](ecosystem/officials/zio-redis.md)
+* [ZIO RocksDB](ecosystem/officials/zio-rocksdb.md)
+* [ZIO S3](ecosystem/officials/zio-s3.md)
+* [ZIO Schema](ecosystem/officials/zio-schema.md)
+* [ZIO SQS](ecosystem/officials/zio-sqs.md)
+* [ZIO Telemetry](ecosystem/officials/zio-telemetry.md)
+* [ZIO ZMX](ecosystem/officials/zio-zmx.md)
+
+### Community Libraries
+
+* [Caliban](ecosystem/community/caliban.md)
+* [Distage](ecosystem/community/distage.md)
+* [LogStage](ecosystem/community/logstage.md)
+* [MUnit ZIO](ecosystem/community/munit-zio.md)
+* [Quill](ecosystem/community/quill.md)
+* [Rezilience](ecosystem/community/rezilience.md)
+* [tamer](ecosystem/community/tamer.md)
+* [TranzactIO](ecosystem/community/tranzactio.md)
+* [ZIO AMQP](ecosystem/community/zio-amqp.md)
+* [ZIO Arrow](ecosystem/community/zio-arrow.md)
+* [ZIO AWS S3](ecosystem/community/zio-aws-s3.md)
+* [ZIO gRPC](ecosystem/community/zio-grpc.md)
+* [ZIO HTTP](ecosystem/community/zio-http.md)
+* [ZIO K8S](ecosystem/community/zio-k8s.md)
+* [ZIO Kinesis](ecosystem/community/zio-kinesis.md)
+* [ZIO Pulsar](ecosystem/community/zio-pulsar.md)
+* [ZIO Saga](ecosystem/community/zio-saga.md)
+* [ZIO Slick Interop](ecosystem/community/zio-slick-interop.md)
+* [ZIO Test Akka HTTP](ecosystem/community/zio-test-akka-http.md)
+
+## ZIO Compatible Libraries
+
+To learn about ZIO compatible libraries, see [this section](ecosystem/compatible.md).
+
+## ZIO Tools
+
+To learn about tools that are useful for ZIO development, see [this section](ecosystem/tools.md).
+
+## Project Templates
+
+In this section, we introduce a list of [project templates](ecosystem/templates.md) that can be used to quickly start a new project.
+
diff --git a/internal-macros/shared/src/main/scala/zio/internal/TerminalRendering.scala b/internal-macros/shared/src/main/scala/zio/internal/TerminalRendering.scala
@@ -132,7 +132,7 @@ object TerminalRendering {
        | Call your $effectType's ${"provide".green.bold} method with the layers you need.
        | You can read more about layers and providing services here:
        | 
-       |   https://zio.dev/next/references/contextual/
+       |   https://zio.dev/next/reference/contextual/
        |
        |${line.red}
        |

diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
@@ -9,6 +9,11 @@ const config = {
   organizationName: 'zio',
   projectName: 'zio',
   themeConfig: {
+    docs: {
+      sidebar: {
+        autoCollapseCategories: true,
+      },
+    },
     prism: {
       // In case we want to use one of the json packaged themes, we can simply require those 
       //theme: require('prism-react-renderer/themes/vsDark'),
@@ -28,7 +33,7 @@ const config = {
       },
       items: [
         { type: 'docsVersion', label: 'Overview', position: 'right' },
-        { type: 'doc', docId: 'references/index', label: 'References', position: 'right' },
+        { type: 'doc', docId: 'reference/index', label: 'Reference', position: 'right' },
         { type: 'doc', docId: 'guides/index', label: 'Guides', position: 'right' },
         { type: 'doc', docId: 'resources/index', label: 'Resources', position: 'right' },
         { type: 'doc', docId: 'about/about_index', label: 'About', position: 'right' },