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

Proposed navigation for knative.dev/docs #1050

Closed
rgregg opened this issue Mar 21, 2019 · 6 comments
Closed

Proposed navigation for knative.dev/docs #1050

rgregg opened this issue Mar 21, 2019 · 6 comments
Labels
kind/meta Documentation about the repo -- contributor roles, issue templates, etc. priority/high
Milestone

Comments

@rgregg
Copy link
Contributor

rgregg commented Mar 21, 2019

Describe the change you'd like to see
The navigation for knative.dev/docs today is a bit all over the place (since it's based on the structure of the files). It makes it hard to find and consume the information in a logical order.

I'd recommend we order the content so that browsing the website can help you through the user journey for onboarding and using Knative.

I've created a proposed hierarchy for the content in a sheet I've put in the team drive.

@samodell
Copy link
Contributor

Related to #986

@samodell samodell added the kind/meta Documentation about the repo -- contributor roles, issue templates, etc. label Mar 29, 2019
@samodell
Copy link
Contributor

@rgregg -- I have an update on this. The "Information Architecture Task Force" met today to talk about your proposal and to each draft proposals of our own. You can see our meeting notes here, and our proposals were added to the sheet where you drafted yours.

Next, I'm going to consolidate the multiple proposals into one and then post it as an issue in the Docs repo and invite community input, and then once we resolve any community comments, we'll get started on implementing the new structure.

@RichieEscarez
Copy link
Contributor

RichieEscarez commented Aug 14, 2019

Hi all,

A revised "navigation" proposal - "Serving V1 proposal" has been added to the shared Google Sheets doc in the team drive.

Request for Action:
PTAL and provide feedback.

Sometime next week we will begin moving the content around to generate a staged/working copy (and incorporate your feedback). Please try to provide your feedback (in the proposal) before then.

@RichieEscarez RichieEscarez added this to To do in Knative Serving V0.10.x via automation Sep 3, 2019
@RichieEscarez RichieEscarez removed this from In progress in Knative Documentation Website Oct 2, 2019
@RichieEscarez RichieEscarez moved this from In progress to Review in progress in Navigation changes - Info architecture Oct 10, 2019
@samodell samodell modified the milestones: Serving 0.10.x, Backlog Nov 11, 2019
@knative-housekeeping-robot

Issues go stale after 90 days of inactivity.
Mark the issue as fresh by adding the comment /remove-lifecycle stale.
Stale issues rot after an additional 30 days of inactivity and eventually close.
If this issue is safe to close now please do so by adding the comment /close.

Send feedback to Knative Productivity Slack channel or file an issue in knative/test-infra.

/lifecycle stale

@knative-prow-robot knative-prow-robot added the lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale. label Feb 10, 2020
@knative-housekeeping-robot

Stale issues rot after 30 days of inactivity.
Mark the issue as fresh by adding the comment /remove-lifecycle rotten.
Rotten issues close after an additional 30 days of inactivity.
If this issue is safe to close now please do so by adding the comment /close.

Send feedback to Knative Productivity Slack channel or file an issue in knative/test-infra.

/lifecycle rotten

@knative-prow-robot knative-prow-robot added lifecycle/rotten Denotes an issue or PR that has aged beyond stale and will be auto-closed. and removed lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale. labels Mar 11, 2020
@RichieEscarez RichieEscarez removed the lifecycle/rotten Denotes an issue or PR that has aged beyond stale and will be auto-closed. label Mar 11, 2020
@abrennan89
Copy link
Contributor

We're working on this in the WG now as a group. It doesn't make sense really to have an issue tracking this, because it's a huge project with multiple participants, and we will create individual issues for each requirement or user story.
cc @carieshmarie

Navigation changes - Info architecture automation moved this from Review in progress to Done Jun 2, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
kind/meta Documentation about the repo -- contributor roles, issue templates, etc. priority/high
Projects
No open projects
Development

No branches or pull requests

7 participants