Repository navigation
Collab Summit Brainstorming / Docs / Learn #7197
Description
triage / assess / breakout after the session
see also learn content read out
- created Create a way to display and manage content freshness learn#33
- metadata on pages to tag last update
- distinction between last reviewed and last updated
- flag when content gets stale
- metadata on pages to tag last update
- need more team accountability - not actionable
- not a lot of folks want to write
- we dont even get changelogs and release notes
- make sure the code is runnable - created Make sure all code examples are runnable #7293
- frontmatter on learn pages tying to core apis - created Map and add frontmatter on learn pages tying to core apis #7294
- CODEOWNERS improvements associated to teams related to the APIs highlighted in the learn content - created Expand CODEOWNERS to each learn section owner/advocate #7292
- translation ?? we have trouble maintaining
entoday. taking no action on this. consensus at collab summit is we have low confidence we can do this. there is still chatter on crowdin about disappoint about this decision - we need information architecture work on the learn section | Meta: Learning Path for Node.js learn#31
- this is more like a graph than a linear path
- can we point to courses or books or videos? pandoras box / conflict of interest
- node.js ambassadors / dev rel content
- can we find technical writers to help
- we should explore paying for this via open collective
Activity
AugustinMauroy commentedon Nov 9, 2024
IMO
I'm more in favour of the version used in the example. Because a date has no value in relation to the runtime. In addition, having the version allows the contributor/collaborator to know if a document needs to be revised.
And from a functional point of view, I think we should add a bit to the
MetaBarthat allows you to install (redirect to the installation of the correct version).I'd be more in favour of having an MDX component that puts the displayName and stability index linked to the version (idea above of having it in the frontmatter) and that also allows links on the page.
I think we just have to note on the issue that talks about this that for the moment it's not a good idea because the content isn't ‘refined’ enough yet.
The ‘learning’ path must be a graph because node.js can be used for all sorts of things (CLI, http, automation, etc.). This means that you can't have a linear flow, you can't start with CLI then HTPP, nothing links them, they have to be run in parallel.
bmuenzenmeyer commentedon Nov 29, 2024
closing this issue, all issues broken out for further triage.
thanks @AugustinMauroy for your initial thoughts