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

Design new documentation content structure #3942

Closed
peholmst opened this issue Nov 21, 2024 · 2 comments
Closed

Design new documentation content structure #3942

peholmst opened this issue Nov 21, 2024 · 2 comments
Assignees

Comments

@peholmst
Copy link
Member

peholmst commented Nov 21, 2024

We need to gradually refactor and improve our documentation. To make this easier, and to avoid SEO and redirection issues, we need to know the overall content structure up front.

Requirements:

  • The Getting Started section should contain everything you need to build a new application from scratch and deploy it to production (the "happy path"). It should be very hands-on, focusing on what you need to do rather than why.
  • The Building Apps section should contain everything you need to know to succeed with Vaadin. It should be possible to read it like a book, from start to finish.
  • Very technical articles should have their own section, so that they don't interrupt the flow of Building Apps, or confuse new users.
  • The documentation covers Vaadin as a platform, not as a set of individual products.
  • Different content is aimed at different users. Should we make personas of our audience?
@peholmst
Copy link
Member Author

Actual work on this issue happens in a Google doc.

@peholmst
Copy link
Member Author

peholmst commented Feb 6, 2025

Closing this issue as the structure has changed radically from what was listed in this ticket because of #4071 .

@peholmst peholmst closed this as completed Feb 6, 2025
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

No branches or pull requests

2 participants