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

content(blog/events): Dublin collab summit 2024 #7215

Merged
merged 21 commits into from
Nov 22, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
57f8e37
cotent(blog/events): dublin collab summit 2024
AugustinMauroy Nov 11, 2024
bfe4d00
fix-typo
AugustinMauroy Nov 12, 2024
5f7a00f
WIP
AugustinMauroy Nov 12, 2024
951be19
WIP
AugustinMauroy Nov 13, 2024
c6a411b
Add more info about bsk
AugustinMauroy Nov 14, 2024
9399263
fix grammar and typo
AugustinMauroy Nov 14, 2024
355c92a
fix typo and grammar
AugustinMauroy Nov 14, 2024
f14d8f1
WIP
AugustinMauroy Nov 14, 2024
c1c7bfb
change the homepage notification per feedback, lengthen time
bmuenzenmeyer Nov 22, 2024
3aa4e1d
normalized the first session with previous format
bmuenzenmeyer Nov 22, 2024
87e68c8
normalized the second session with previous format
bmuenzenmeyer Nov 22, 2024
6ec6543
normalized the third session with previous format
bmuenzenmeyer Nov 22, 2024
6a44998
normalized the fourth session with previous format
bmuenzenmeyer Nov 22, 2024
150a66c
normalized the fifth session with previous format
bmuenzenmeyer Nov 22, 2024
020637c
normalized the sixth session with previous format
bmuenzenmeyer Nov 22, 2024
f3c9c0e
normalized the seventh session with previous format
bmuenzenmeyer Nov 22, 2024
0f46605
normalized the eigth session with previous format
bmuenzenmeyer Nov 22, 2024
28e3048
cleanup final section, add more presenters per the session proposals,…
bmuenzenmeyer Nov 22, 2024
36704d3
normalize end thanks
bmuenzenmeyer Nov 22, 2024
856f262
remove personal note, as much as i like it
bmuenzenmeyer Nov 22, 2024
b17e145
remove outlier blockqoute
bmuenzenmeyer Nov 22, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions apps/site/authors.json
Original file line number Diff line number Diff line change
Expand Up @@ -248,5 +248,10 @@
"id": "MattIPv4",
"name": "Matt Cowley",
"website": "https://github.com/MattIPv4"
},
"AugustinMauroy": {
"id": "AugustinMauroy",
"name": "Augustin Mauroy",
"website": "https://github.com/AugustinMauroy"
}
}
102 changes: 102 additions & 0 deletions apps/site/pages/en/blog/events/collab-summit-2024-dublin.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
---
date: '2024-11-11T00:00:00.000Z'
category: events
title: 'Trip report: Node.js collaboration summit (2024 Dublin)'
layout: blog-post
author: AugustinMauroy
---

<!--
day 1: https://hackmd.io/-8o2Th28QhuNJwO43fafAw
day 2: https://hackmd.io/V3xtjlcrTIGsemPv8t-tKg
-->
bmuenzenmeyer marked this conversation as resolved.
Show resolved Hide resolved

Following the successful Node.js collaboration summit in London earlier this year, the Node.js community gathered once again for the second summit of 2024. This time, the event was hosted by [Baseline](https://www.baseline.community/events), a community and workshop space in Dublin.

The [second collaboration summit of 2024](https://github.com/openjs-foundation/summit/issues/419), held on 7-8 November, continued the tradition of sharing knowledge, brainstorming solutions, and pushing forward new initiatives within the Node.js ecosystem. This edition focused on a range of topics, from collaborator health and diversity to documentation improvements and technical advancements. Here is a recap of what happened at the summit.
AugustinMauroy marked this conversation as resolved.
Show resolved Hide resolved

## Collaborator health survey

## Next-10 Survey

## To know you is to love you. Diversifying Node.js

## Next 10 - Deep dive on funding

## Documentation Improvements (Node.js learn section)

The documentation session focused on improving the "Learn" section of the Node.js website, aiming to make it more accessible and up-to-date for newcomers and experienced developers alike. The discussion was initiated by Stephen and taken up by Claudio (Who is node.js website maintainer).
AugustinMauroy marked this conversation as resolved.
Show resolved Hide resolved

### Key Points Discussed

- **Website Redesign and Current State**: Claudio discussed the ongoing website redesign and the current state of the documentation. The consensus was that the "Learn" section needs more attention and regular updates.

- **Ownership and Responsibility**: Augustin pointed out that there is no clear ownership of the content in the "Learn" section. This lack of responsibility makes it challenging to keep the documentation updated.

- **Linking to Changes**: Jacob suggested adding links in the "Learn" section to mention all the changes, making it easier for users to track updates.

- **Last Updated/Reviewed**: Alexander proposed adding a "last updated" or "last reviewed" section to reflect the currency of the documentation. This would help users understand how up-to-date the information is.

- **Translation and Sync Issues**: Brian and Matteo discussed the challenges of translating the "Learn" section. While Crowdin helps keep translations up-to-date, there were concerns about the potential for misinterpretations and the difficulty of maintaining external translations.

- **Target Audience and Content Relevance**: Matteo emphasized the importance of understanding the target audience for the "Learn" section. The discussion highlighted the need for a more structured flow that introduces basic concepts in a way that makes sense for beginners. It was noted that the current content includes deep topics like profiling but lacks essential content like HTTP, which can lead users to seek outdated information elsewhere.

- **Content Creators and Contributors**: Stephen suggested reaching out to known content creators to contribute to the "Learn" section. The idea of creating a scroll of "things that you should know" was also proposed to guide users through essential topics.

- **External Content and Verification**: Alexander suggested pointing to external content from the website, but Claudio raised concerns about the difficulty of verifying the quality and relevance of external resources.

- **API Docs vs. Learn Section**: Augustin clarified that the "Learn" section should not be a course but rather a guide with examples using the API docs. The goal is to provide practical examples and guidance rather than comprehensive tutorials.

### Potential Action Items

- **Identify Owners**: Establish clear ownership and responsibility for the "Learn" section to ensure regular updates and maintenance.

- **Update Content**: Ensure that the "Learn" section is updated regularly to reflect the latest changes and best practices.

- **Add Last Updated/Reviewed**: Implement a "last updated" or "last reviewed" section to indicate the currency of the documentation.

- **Improve Translation Process**: Continue using Crowdin for translations but be mindful of potential misinterpretations and the challenges of maintaining external translations.

- **Define Target Audience**: Clearly define the target audience for the "Learn" section and structure the content to meet their needs.

- **Engage Content Creators**: Reach out to known content creators to contribute to the "Learn" section and create a scroll of essential topics.

- **Verify External Content**: If pointing to external content, ensure that it is verified and relevant to the needs of Node.js users.

- **Differentiate from API Docs**: Ensure that the "Learn" section provides practical examples and guidance rather than comprehensive tutorials, differentiating it from the API docs.

### Summary

The documentation session highlighted the need for improved ownership, regular updates, and a clear understanding of the target audience for the "Learn" section. By addressing these issues, the Node.js community can provide more accessible and up-to-date documentation that meets the needs of both newcomers and experienced developers.

> If you want to follow the discussion, you can check the [collab summit brainstorming notes](https://github.com/nodejs/nodejs.org/issues/7197).

## Module loading customization/optimization and CJS/ESM interoperability

ESM as first class ???
`node --inti` like `npm init` but with `type` key to `module`.
also https://github.com/pkgjs/create-package-json mention by wes

## Facilitating userland migrations to new features and breaking changes

This session was presented by [Jacob Smith](https://github.com/JakobJingleheimer).

## Node.js Diagnostics WG meeting

Diagnostic doesn't work with ESM so issue for "ESM as first class"

## Tooling group session

- X -> 🦋
AugustinMauroy marked this conversation as resolved.
Show resolved Hide resolved

## Personal note

> I think that was the part that touched and pleased me the most. It was the connection with the people. Because everyone involved is great. These are people I'd only been able to talk to online, and here you meet them in real life.
>
> <cite>Augustin Mauroy</cite>
AugustinMauroy marked this conversation as resolved.
Show resolved Hide resolved

## Thanks

Thanks to all the attendees. Special thanks to the Baseline team for hosting the summit and providing a welcoming space for the Node.js community.

Also big thanks to Claudio Wunder, Matteo Collina, Robin Ginn, and the [OpenJS Foundation](https://openjsf.org) for organizing the event and making it possible.
10 changes: 5 additions & 5 deletions apps/site/site.json
Original file line number Diff line number Diff line change
Expand Up @@ -37,12 +37,12 @@
},
"websiteBadges": {
"index": {
"startDate": "2024-09-01T00:00:00.000Z",
"endDate": "2024-10-01T00:00:00.000Z",
"startDate": "2024-11-01T00:00:00.000Z",
"endDate": "2024-12-01T00:00:00.000Z",
"kind": "default",
"title": "Discover",
"text": "TypeScript in Node.js",
"link": "https://nodejs.org/en/learn/typescript/introduction/"
"title": "Read",
"text": "Dublin Node.js Collab Summit",
"link": "https://nodejs.org/en/blog/events/collab-summit-2024-dublin"
}
}
}
Loading