Before You File a Documentation Request Please Confirm You Have Done The Following...

• I have looked for existing open or closed documentation requests that match my proposal.
• I have read the FAQ and my problem is not listed.

Suggested Changes

Right now the @babel/* versions in our package.json are out of date, behind e.g. @babel/[email protected]:

I'm also seeing in fixtures-to-test.ts that there are some ignored fixture files due to previously filed Babel issues that have since been resolved:

When I update the @babel/* packages to latest, remove those ignores, and run typescript-estree tests, there are snapshot failures in typescript/expressions/instantiation-expression.src.ts. https://github.com/typescript-eslint/typescript-eslint/actions/runs/3490803456/jobs/5842786077

             91 |     // Received = Babel, Expected = TSESTree
           > 92 |     expect(babelAst).toEqual(tsestreeAst);

It'd be helpful to have the system of fixtures and snapshots documented. In particular I'd like to document what to do when these discrepencies show up in a package bump or AST fix.

#5885 is another example of where the docs would be helpful.

Edit: some context here too: #5717 (review), #5926 (comment)

Affected URL(s)

https://typescript-eslint.io/docs/maintenance/package-updates, maybe?