New area for userland migrations

[JakobJingleheimer]

Enter your suggestions in details:

The new userland migrations needs a place on nodejs.org to publicise its existence and explain how to use it. Each API doc may reference a specific migration recipe (probably a link to github), but the overall concept should have its own place. Perhaps a Learn section for authorship and consumption?

[ovflowd]

Can you elaborate more?

[AugustinMauroy]

I'm not 100% sure that good idea to put it in learn but idk where we can put that. Maybe a new subsection on about but not really right

[JakobJingleheimer]

Can you elaborate more?

In what regard? Ex do you want to know what "userland migrations" are, or are you wondering about the content for the new website section?

[bmuenzenmeyer]

it'd be kinda nice to include within:

• changelogs / releases
• within https://nodejs.org/en/about/previous-releases#looking-for-latest-release-of-a-version-branch

perhaps you've given it more thought too @JakobJingleheimer but i am a big +1 to provide this in as many places people will see it

here's some MUI examples

inline within relevant docs

upgrade posts

https://mui.com/material-ui/migration/upgrade-to-v6/#breaking-changes

[JakobJingleheimer]

Yes! If the codemod is available when the feature is released (the ideal case), I think it should definitely be included in the release notes / changelog 🙂

[ovflowd]

I believe Brian replied to the questions I had (unintentionally); I wasn't sure what this was about, but having little info boxes across pages mentioning these makes sense to me :)

[JakobJingleheimer]

I believe Brian replied to the questions I had (unintentionally); I wasn't sure what this was about, but having little info boxes across pages mentioning these makes sense to me :)

Including in the changelog is not the request (that has nothing to do with the website team 😜).

Userland Migrations is what I presented in Dublin. See the readme for an explanation of what it is: https://github.com/nodejs/userland-migrations/tree/chore/initial-setup

[mikeesto]

If I'm understanding correctly - what @JakobJingleheimer is proposing is a new page (or pages) on Learn that explain what codemods are and how to use them. That sounds OK to me.

[AugustinMauroy]

Yeah @mikeesto I think you got right. But my question is, is the right place ?

[JakobJingleheimer]

Yes, exactly :) Learn was just a starting-point / suggestion.