feat(ServerComponent): add method to render simplified html

[LeoMcA]

Description

• Adds a renderSimple method to the server component class, which can be overwritten in a component to define a simplified HTML version of the component
• Does this for the Doc component to render simply the page contents, no sidebars etc.
• Doesn't render the outer layout either

Motivation

• Main motivation is to provide a better API than the hacky one used in feat: add get-doc tool mcp#10
  • With the renderSimple export in entry.ssr.js I don't have to set up async local storage, mock fluent, etc.
  • Will also easily allow us to define simple forms of other components, e.g. Baseline or BCD, rather than maintaining a custom implementation divorced from the "real" component
• This could also prove useful for other purposes we might want to explore in the future: an alternative offline option, embedding in devtools, etc.

Testing

For a preview of the simple form of a component, run:

FRED_SIMPLE_HTML=true npm start

And then navigate directly to a doc page (other page types will render nothing), e.g. http://localhost:3000/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/isSafeInteger

Screenshot

[github-actions]

bf48e08 was deployed to: https://fred-pr1072.review.mdn.allizom.net/

[caugner]

Could we avoid renderSimple() if an environment variable just caused this effect?

[LeoMcA]

Could we avoid renderSimple() if an environment variable just caused this effect?

Hmm, let me think about this: I think though it would make the component code more complex, and I think there's a nice simplicity to just having two render methods on components which need them.

[caugner]

LGTM overall, just three more nits:

1. Should the method be called renderSimplified() or renderMinimal() to make it clearer what this method does.
2. Can we mention this in the docs (README?).
3. Could every renderSimple() implementation incl. default implementation explain in JSDoc what it omits?

[caugner]

nit: add description of this method

[caugner]

nit: explain what this method omits (even if it's comparably trivial from looking at render/renderSimple side-by-side

[caugner]

nit: explain what this simplified/minimal rendering omits