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.

Sign up for GitHub

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

Jump to bottom

Docs Feedback #261

Closed
plumbis opened this issue Jan 12, 2023 · 2 comments
Closed

Docs Feedback #261

plumbis opened this issue Jan 12, 2023 · 2 comments
Assignees
@plumbis
Labels
feedback Issues tracking general docs feedback

Comments

@plumbis
Copy link
Collaborator

plumbis commented Jan 12, 2023

Feedback from @elohmrow-

  • Need a nice tutorial
  • Lots of component documentation but nothing that brings it together to "see the whole platform vision"
  • the structure of the documentation makes it unclear where to find things
  • Configuration examples don't show how to make your own configurations to build a platform
  • confusing Crossplane terms make reading challenging
@plumbis plumbis added the feedback Issues tracking general docs feedback label Jan 12, 2023
@plumbis
Copy link
Collaborator Author

plumbis commented Feb 1, 2023 •
edited
Loading

Need a nice tutorial

v1.11 includes a step-by-step AWS getting started (soon to expand to GCP and Azure)

the structure of the documentation makes it unclear where to find things

v1.11 has a significant reorganization of the content (#271) to try and improve discoverability.

confusing Crossplane terms make reading challenging

More work to do but the AWS getting started guide regularly spells out the terms. A new intro introduces each term and puts them in context.

@plumbis
Copy link
Collaborator Author

plumbis commented Jul 26, 2023

Calling the remaining points solved with #475.

@plumbis plumbis closed this as completed Jul 26, 2023
@plumbis plumbis self-assigned this Jul 26, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@plumbis plumbis

Labels
feedback Issues tracking general docs feedback
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@plumbis