(docs) Request for elaboration on usage docs for defineEntries

[tylersayshi]

defineEntries is a fn call to define how to render, build, and configure the ssr for your waku app.

Some initial usage docs live here: https://github.com/dai-shi/waku/blob/main/docs/minimal-api.mdx

It would be really helpful for someone new to look through how the initial usages of defineEntries are used, then summarize some info in a docs entry for this function.

[ojj1123]

I was wondering if you could explain where it is the explanation of defineEntries function in Docs or README! I couldn't find it since waku was released as v0.19.0. Is it deprecated

#24 (comment)

Oh I was also wondered defineEntries before releasing managed mode. If it's important to know this API for library authors, it's good to describe this API. Reading the source code of it briefly, It feels like it's working for build process. But it's too hard for newcomers to know about it.

waku/packages/waku/src/lib/builder/build.ts

Line 750 in 901594c

const distEntries = await import(filePathToFileURL(distEntriesFile));

How about explain API descriptions like what each parameter work for or the interaction of parameters(renderEntries, getBuildConfig, getSsrConfig)? And then I feel like that it's easier to know and investigate the use cases of this API.

[rmarscher]

I saw that new_defineEntries() is now available.

• https://github.com/dai-shi/waku/blob/main/examples/31_minimal/src/entries.tsx
• https://github.com/dai-shi/waku/blob/v0.21.6/packages/waku/src/minimal/server.ts#L64-L114

[dai-shi]

We are in the middle of refactoring. defineEntries will be replaced with new_defineEntries soon-ish.

[dai-shi]

@tylersayshi I'm not sure if this is a good first issue anymore.