-
Notifications
You must be signed in to change notification settings - Fork 1.1k
Description
At the moment, the Application page in "Behind the scenes" is mixing explanations with how-to guides. This makes it difficult for our users to find the relevant content (a recipe to achieve the outcome they want).
As part of our adoption of the four-quadrant documentation system (see #5549 and #5718), we should extract all guides from explanation pages into guide pages (see #5768 for inspiration) and keep explanation pages focused on explaining the concepts & providing background information.
This story is a part of Epic #5783 move recipes to how-to guides.
Acceptance criteria
Move the following recipes into "How-to guides", decide yourself whether to create a new page for each recipe or group multiple recipes in one page.
-
How to register artifacts like components, controllers and servers to the application.
I think we should have a single page for all of them, we should mention non-core artifacts like DataSources and Repositories too, and include instructions for adding artifacts via project-layout conventions, where the artifacts are picked up and registered by
@loopback/boot.
Consider adding a "Common tasks" section to "Application" page, it should list pointers to new how-to guides. See Server >> Common tasks for inspiration.