Skip to content

Conversation

@SensibleWood
Copy link

No description provided.

@SensibleWood SensibleWood linked an issue Nov 3, 2025 that may be closed by this pull request

```text
Learn
├── What Is OpenAPI? (Relocate existing page).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
├── What Is OpenAPI? (Relocate existing page).
├── What Is OpenAPI Initiative? (Relocate existing page).

To avoid confusion with the specification itself. We can explain all 3 specs briefly on that page.

Learn
├── What Is OpenAPI? (Relocate existing page).
├── [Learn About OAI](https://learn.openapis.org/)
├── [OAI Courses](https://training.linuxfoundation.org/full-catalog/?_sf_s=openapi)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
├── [OAI Courses](https://training.linuxfoundation.org/full-catalog/?_sf_s=openapi)
├── [Online Courses](https://training.linuxfoundation.org/full-catalog/?_sf_s=openapi)

The following are the drop downs we should aim for.

```text
Learn
Copy link
Member

@pavelkornev pavelkornev Nov 5, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shall we add Tooling under Learn? Or we can add something like Ecosystem, where we can have learn materials + tooling

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ooh I like ecosystem! But will that draw the right attention?

├── [Overlay](https://spec.openapis.org/overlay)
├── [Registries](https://spec.openapis.org/registry/)
Community
├── [Collaborate on Slack](https://communityinviter.com/apps/open-api/openapi)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We're going to have Slack/GitHub icons. Do we need a dedicated menu item for Slack? Though, i think it might be important to have a page to describe how collaboration happens in OAI. E.g. the main communication channel is Slack, it's divided into sub-channels for each spec/SIG, etc. Also, how to join community meetings, not everyone knows where to find this information.

Comment on lines +54 to +55
> HERE LETS HAVE A CAROUSEL OF MEMBER LOGOS THAT AUTO TRANSITIONS RIGHT TO LEFT, SHOWING MEMBER LOGOS
> Button under the carousel - "All Current Members" - goes to https://www.openapis.org/members
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this part of the member value proposition? Because otherwise, it is permanently ceding tremendously valuable screen real estate to a single purpose. Also, not all web pages need a carousel. It's usually used when you are trying to sell things and want to put different options in front of visitors immediately, in a way that can be updated quickly.

Our list of members does not change very often, and what benefit do we get from routing traffic to them? Again, if that's part of our member value proposition that's one thing, but eating up this part of the web site has a big cost.

It's more common to see a grid of members/contributors/sponsors further down. If we must have a carousel, it should be used to highlight timely events and announcements that we want users to take action on.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agree on the carousel for announcements... e.g. events, new spec versions, or maybe even new members... e.g. Jentic just signed up to support OAI, there was a post on LinkedIn, in addition we could have a banner in a carousel for a month on the main page or so as part of the package for new members.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pavelkornev yes, announcing a new member would be a good use, as it's a transient but important thing to highlight.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: Website redesign notes

4 participants