Training exercise.
# Information Architecture comparison

This is the comparison of three approaches to API documentation architecture we prepared.

## Navbar

Navbar: Redocly's navbar offers intuitive navigation tools, allowing users to swiftly move between sections, search for specific endpoints, and access key documentation features with ease. With its clean design and customizable options, the navbar enhances user experience while exploring API documentation.
![navbar-architecture.png](/assets/navbar-architecture.d90cebc2e7b5ba094fc9a66a91d808cd92f8f8bbe303efd63f73e03c30400232.9c1bb791.png)

## Sidebar

Sidebar: Redocly's sidebar provides a structured overview of API endpoints and resources, facilitating efficient navigation and exploration. Users can quickly browse through different sections, expand or collapse subsections, and access detailed documentation for each endpoint. The sidebar streamlines the user journey, making it simple to locate relevant information and understand the API's capabilities.
![sidebar-architecture.png](/assets/sidebar-architecture.6d179b92bc70658a9002f1dcffa3e7b206cc72c301eb40c4302b471302c85783.9c1bb791.png)

## Catalog

Catalog: Redocly's catalog feature offers a comprehensive index of all available endpoints and resources within the API documentation. Users can browse through the catalog to discover various functionalities, view detailed descriptions, and access relevant examples and usage guidelines. The catalog serves as a centralized hub for exploring the API's capabilities, enabling developers to find the information they need quickly and efficiently.
![catalog.png](/assets/catalog.079ed5b970e3c677015aa055c124c9205994679f540295d2cf2a171e904cefeb.9c1bb791.png)

## Conclusion

From the user experience, where you have a small number of APIs, the sidebar or navbar is the best option. However, for a large number of separate API modules, the best approach are the catalog tiles wheter the user can access each title individually.