docs: Next.js 14

[leerob]

• Fetch logging configuration is no longer experimental
• Add unstable_noStore reference
• Add unstable_cache reference
• Add codemod docs for next/og import changes
• Update docs around stable Server Actions
• Add example of revalidating the entire data cache
• Update static export docs for next export command removal
• Update minimum required Node.js version
• Add viewport and generateViewport reference

[leerob]

Still need to add a reference for #57287, will do that shortly.

[molebox]

Left committable suggestions for ease. Some are questions so feel free to resolve if not adding them 👍🏻

[mwskwong]

There are 3 questions raised when I'm reading this. It would be super helpful if the doc also addressed those.

1. Does unstable_cache also handle deduplication, which is not the case for the current version of this API?
2. Is it supposed to be used OUTSIDE of a component, instead of inside as suggested in the previous version of the doc?
3. If the answer to (3) is yes, then how should one specify tags that depend on the function arguments? e.g.

const getCachedUser = unstable_cache(
  async (id) => getUser(id),
  ['user'],
  { tags: [`user-${id}`] }  // ???
);

[alfonsusac]

Both current and previous docs, unstable_cache can be used both inside and outside of the component. However, when calling the function returned from unstable_cache it has to be inside.
Based on my current understanding, this is because the object that is used to access the cache IncrementalCache only exists inside a serverless function such as Server Components and generateMetadata() which is why it will throw an error if called outside of the component.

I assume the example below is used so that one can export the function and use it somewhere else. This is, through my experience, done by wrapping unstable_cache with a function that receives any external data which can be passed to the keyParts and inside the callback function.

Example:

const getCachedUser = (slug) => unstable_cache(
  async (slug) => getUser(slug),
  ['my-app-user'],
  { tags: [`user-${slug}`] }
)(slug);

export default async function Component({ userID }) {
  const user = await getCachedUser(userID);
  ...
}

This has worked for me, last time i checked in 13.4.9

[github-actions]

All broken links are now fixed, thank you!

Addressed