-
Notifications
You must be signed in to change notification settings - Fork 10
docs: Updating homepage to new model for 26.04 #36
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
Conversation
bb930f6 to
04f60a3
Compare
…to updating-homepage
cjdcordeiro
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
thanks for the changes, almost there
Co-authored-by: Cristovao Cordeiro <cristovao.cordeiro@canonical.com> Signed-off-by: Anna Sancho Vaquer <anna.sanchovaquer@canonical.com>
Signed-off-by: Anna Sancho Vaquer <anna.sanchovaquer@canonical.com>
Co-authored-by: Cristovao Cordeiro <cristovao.cordeiro@canonical.com> Signed-off-by: Anna Sancho Vaquer <anna.sanchovaquer@canonical.com>
Signed-off-by: Anna Sancho Vaquer <anna.sanchovaquer@canonical.com>
Signed-off-by: Anna Sancho Vaquer <anna.sanchovaquer@canonical.com>
cjdcordeiro
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you very much for all the back and forth. It turned out quite well, and I'm leaving a couple of non-blocking comments for us to follow up on ;)
| compact, secure software. | ||
|
|
||
| Developers need to be able to create software suited to their specific needs with a reduced attack | ||
| Users need to be able to create software suited to their specific needs with a reduced attack |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I won't block the PR on this, cause it's quite nuanced, but just food for thought: in the line above, Chisel is depicted as a "developer tool". The conotation is different, which doesn't make the use of "Users" wrong here (IMO), but worth noting, just in case you have a different interpretation
|
|
||
| --------- | ||
|
|
||
| This documentation uses the [Diátaxis documentation structure](https://diataxis.fr/). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for being willing to try this out.
This looks good enough for now. But I'd like to find a better place for it still.
Just continue discussing the following on the side:
- In the rockcraft docs, there's a special "docs contributions" page (https://documentation.ubuntu.com/rockcraft/stable/contribute-to-this-documentation/). Is that part of the template? If we're having one as well for Chisel, isn't that the obvious place to have this reference? TBC
ROCKS-2627
A new model is implemented for the Chisel docs homepage based on the template for 26.04. This includes: