docs: modify sidebar

[dhmlau]

Modify sidebar as proposed in PR #3164.

Current side:

New sidebar:

Checklist

👉 Read and sign the CLA (Contributor License Agreement) 👈

• 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]

Is it the only difference to add a new Overview?

[dhmlau]

Is it the only difference to add a new Overview?

much more. :)

• Overview is the only item I added.
• I've removed: FAQ and Glossary. @bschrammIBM mentioned a while ago and I tend to agree with her that those two pages aren't very useful. We have key concepts that are duplicate of glossary.
• For others, I've rearranged per the proposal.

[dhmlau]

@raymondfeng , I'd like to get the simpler/less controversial changes in this PR first, and then make a bigger refactoring for the key concepts and other section.

[hacksparrow]

API Docs should stand out as a separate link at the top or bottom of the list shown. The most crucial link can't be "lost" somewhere down the list.

[dhmlau]

There's a API Docs at the top of the page, as part of the template.
However, it is pointing to apidocs.loopback.io. If someone is using LB4 and click that link, he/she will be asked to click another link for the LB4 API docs. I guess the best way is to move the API docs completely (with LB3) to our docs.

[raymondfeng]

Should we move Tutorials down?

[dhmlau]

sure. where to?

[dhmlau]

@raymondfeng, I've moved down the Tutorial section. PTAL. Thanks.