docs: simplify middleware-based sequence

[mrmodise]

Closes #6770

Checklist

• DCO (Developer Certificate of Origin) signed in all commits
• npm test passes on your machine
• New tests added or existing tests modified to cover all changes
• Code conforms with the style guide
• API Documentation in code was updated
• Documentation in /docs/site was updated
• Affected artifact templates in packages/cli were updated
• Affected example projects in examples/* were updated

👉 Check out how to submit a PR 👈

[raymondfeng]

@mrmodise Thank you for the PR.

For sequences, we basically have two styles:

1. The legacy action based sequence - it consists of a series of actions in form of functions that are pre-generated in the src/sequence.ts. LoopBack ships DefaultSequence as the base.

2. The new middleware-based sequence - it is a middleware chain that discovers and invokes middleware. The base class is MiddlewareSequence.

Both sequence are extensible and customizable. The legacy sequence has a middleware action that allows plugging in additional middleware. The new sequence is fully composable from middleware via the extension point/extension pattern. Each style has a base class to be extended for customization.

[mrmodise]

Thanks @raymondfeng based on your comments I think even the action-based sequence needs some improvement since the section is mixing a lot of complex topics. Let me do some optimisations there as well. You can review the current changes on middleware-based since thats the one I had targeted

[dhmlau]

@mrmodise, thanks for the PR. I had some minor comments.
For the files to be deleted, I'm wondering if there's an equivalent file for that. If yes, it would be helpful to add redirect_from in the front matter of the md file (example: https://raw.githubusercontent.com/strongloop/loopback-next/master/docs/site/Accessing-services.md). Thanks.

[mrmodise]

https://raw.githubusercontent.com/strongloop/loopback-next/master/docs/site/Accessing-services.md

@mrmodise, thanks for the PR. I had some minor comments.
For the files to be deleted, I'm wondering if there's an equivalent file for that. If yes, it would be helpful to add redirect_from in the front matter of the md file (example: https://raw.githubusercontent.com/strongloop/loopback-next/master/docs/site/Accessing-services.md). Thanks.

I will double check this

[mrmodise]

Discovered gaps while working on 977 cc @achrinza

[achrinza]

Great work thus far! 👍

Sorry I don't have time to fully look through the changes in detail. But this is my initial comments 👇

[mrmodise]

@mrmodise, thanks for the PR. I had some minor comments.
For the files to be deleted, I'm wondering if there's an equivalent file for that. If yes, it would be helpful to add redirect_from in the front matter of the md file (example: https://raw.githubusercontent.com/strongloop/loopback-next/master/docs/site/Accessing-services.md). Thanks.

For the pages to be deleted i split the content across other pages

PTAL @dhmlau

[bajtos]

@mrmodise, thanks for the PR. I had some minor comments.
For the files to be deleted, I'm wondering if there's an equivalent file for that. If yes, it would be helpful to add redirect_from in the front matter of the md file (example: https://raw.githubusercontent.com/strongloop/loopback-next/master/docs/site/Accessing-services.md). Thanks.

For the pages to be deleted i split the content across other pages

I reviewed the new version, no pages are being removed now. Existing links pointing to our docs should keep working after this change.

[bajtos]

Landed, thank you @mrmodise for the contribution! ❤️