Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

OZ-279: Implementer docs structured as evaluate/adopt/deploy. #24

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

rbuisson
Copy link
Contributor

https://mekomsolutions.atlassian.net/browse/OZ-279

This PR introduces:

  • a new nested structure for the implementer section.
  • empty placeholder pages
  • more content

Miro board: https://miro.com/app/board/uXjVLtlG19g=/?share_link_id=37906699100

@mks-d , this might be bringing too much text actually. It does end up with big blocks of text. But there is a lot to say!

@rbuisson rbuisson requested a review from mks-d February 11, 2025 17:08
@mks-d mks-d changed the title OZ-279: Kick start implementer docs OZ-279: Implementer docs structured as evaluate/adopt/deploy. Feb 14, 2025
Copy link
Contributor

@mks-d mks-d left a comment

Choose a reason for hiding this comment

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

The evaluate/adopt/deploy journey is an excellent idea 👍

It's important to onboard consumers into our own terminology around Ozone. Namely: an ecosystem of apps. Let's get rid of the notion of component, and let's avoid the long word (application) in favour of the short one (app).

@rbuisson
Copy link
Contributor Author

Fixes done.
There is some changes to the reader's flow introduced in this PR.
Especially, the Quick Start page.
It's on its own tab now:
Screenshot 2025-02-19 at 16 50 20

But also, it has one single page.
That's pretty ugly but I don't know how to remove that.
Screenshot 2025-02-19 at 16 51 02

Alternatively, we could create 3 pages:

  • Online Demo
  • Locally
  • On Gitpod

I think this will be clearer that the current "Did you check the online demo?" and the 2 tabs for Locally VS Gitpod.

What do you think @mks-d ?

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.

2 participants