Pinned: Current Priorities for the Node.js Website Redesign

[ovflowd]

Hey, y'all 👋 on this pinned Issue, we're briefly explaining the current Priorities and Roadmap for the Node.js Website Redesign.

These features still need to be done and would welcome outside collaboration. This means anybody can join the discussion, give ideas and suggestions, and propose changes. At the Node.js project, we value an open community and your feedback.

Features to be Worked on

Features surrounding our Blog feature

Currently, we have a raw implementation of a /blog page. This page lacks features such as:

• Navigation Section that allows only to see posts per category (Example being https://eslint.org/blog) [eg.: /blog/category/{your-category}]
• The /blog should show the latest posts not separated by category
• Add pagination to the blog categories and main blog page
• Add thumbnails for the blog posts
• And other issues, in general, on our blog feature

There are a couple of issues being tracked to make this happen:

• https://github.com/nodejs/nodejs.dev/issues/2531
• https://github.com/nodejs/nodejs.dev/issues/2566

Features regarding our API Docs

We've recently published the API Docs within Nodejs.dev, a massive milestone for the Website Redesign Project. But we're not done. There are still things that need to be done.

Some of these changes are feature-wise, such as allowing Internationalisation of the Docs, Switching between versions and a more reliable build process. We're close to getting these done!

There are a couple of issues being tracked to make this happen:

• https://github.com/nodejs/nodejs.dev/issues/2743

Translation of Pages

We finally reached the 1:1 content match (Existing Pages and Sections and Content) from Nodejs.org website (or at least we're pretty close!).

For now we're only considering the translation (to kick-off) of the following sections:

• Localisation Configurations (src/i18n/config.json)
• Localisation Entries (src/i18n/locales)
• Contents from:
  • content/about
  • content/get-involved
  • content/download
  • content/homepage

Here's the list of currently partially or fully available translations:

• :us English (Native)
• :fr: French - 50%

Build Process Optimization

These are tasks needed to improve and streamline our content and build process. These are necessary for having sustainable and future-proof nodejs.dev website:

• https://github.com/nodejs/nodejs.dev/issues/2744
• https://github.com/nodejs/nodejs.dev/issues/2743
• https://github.com/nodejs/nodejs.dev/issues/2674
• https://github.com/nodejs/nodejs.dev/issues/2746

Content to be worked on

Currently, there are still a few things that need to be worked to have 1:1 content with Nodejs.org, such as:

• https://github.com/nodejs/nodejs.dev/issues/1406
• https://github.com/nodejs/nodejs.dev/issues/2745

Want to contribute?

How to contribute?

Do you want to contribute? Just do it! No need to ask "Can I contribute", "Can I work on this", and "Can I be assigned on this?", we just expect you to make a Pull Request that follows our Contribution Guidelines.

If you, of course, have any questions regarding how the changes should be written, grammar questions or you're unsure about something regarding the Issue; you're more than welcome to ask 💯

Prioritising changes

Minor documentation inconsistencies have lesser priority in being updated. New Documentation pages for new Node.js features, such as ES Modules, or behavioural differences in internal Node.js tooling, such as NPX have higher priority, and we encourage contributions towards these documentation changes.

[ovflowd]

Note.: This issue is marked as "locked" to avoid off-topic here. As the discussions shall happen on the issues pointed out above.

[ovflowd]

cc @nodejs/i18n @nodejs/translators @nodejs/nodejs-fr @nodejs/nodejs-de @nodejs/nodejs-es @nodejs/nodejs-da @nodejs/nodejs-cn @nodejs/nodejs-ar @nodejs/nodejs-bn @nodejs/nodejs-el @nodejs/nodejs-pt @nodejs/nodejs-ro @nodejs/nodejs-ko @nodejs/nodejs-ru @nodejs/nodejs-uk

This repository is now finally in a state ready for accepting translations. We would be amazed if y'all could contribute with translations. Guidelines here