Skip to content

Consider creating a dedicated docs design #208

@philwebb

Description

@philwebb

Currently docs.spring.io is designed to look like an extension of spring.io and replicates the header and footer menus. Whilst this creates a consistent experience, it does mean that we sacrifice a lot of header space for menus that aren't particularly relevant to developers that are only interested in the docs.

Quite a few site have dedicated documentation sites that differ from their main site. Some examples are:

I think it would be interesting to consider what a dedicate docs site for Spring could look like and what (if any) benefits it would give.

One interesting outcome would be the extra header space we have. For example, we could use it to host the search bar which would make it easier to find when there is a large table of contents navigation tree.

e.g.

Original:

Screenshot 2024-02-21 at 9 39 23 AM

Mock up:

docssite

In the mock up, the chevron next to the Spring logo could provide links to sections of spring.io and possibly also start.spring.io.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions