loopbackio / loopback-next

LoopBack makes it easy to build modern API applications that require complex integrations.
https://loopback.io
Other
4.95k stars 1.07k forks source link

Change the behavior of lb4 CLI #6239

Closed hacksparrow closed 3 years ago

hacksparrow commented 4 years ago

The fact that lb4 scaffolds a REST app by default implies LoopBack 4 (lb4) is a REST framework, when it is not. Users now assume LB4 is a REST framework and go to the website expecting to find the docs of a REST framework, instead they find the documentation of a super-framework.

We should start using --rest for scaffolding REST apps, --graphql for GraphQL app, --grpc for gRPC app etc.

If one has to do lb4 --rest, they will naturally be curious, "Why do we have to add --rest", "What else is there?", "I needed a gRPC app, can LB4 do it?", etc. This sets a better context about what LB4 really is.

I brought it up on https://github.com/strongloop/loopback-next/issues/5551 and repeat it again, our documentation problem is more of an identity problem than organization problem; the docs re-organization exercise can fix it only to a certain extent. Unless we decide on a clear cut identity of LB4 and back it up with docs and tooling, the core of the problem will still remain.

Acceptance Criteria

stale[bot] commented 3 years ago

This issue has been marked stale because it has not seen activity within six months. If you believe this to be in error, please contact one of the code owners, listed in the CODEOWNERS file at the top-level of this repository. This issue will be closed within 30 days of being stale.

stale[bot] commented 3 years ago

This issue has been closed due to continued inactivity. Thank you for your understanding. If you believe this to be in error, please contact one of the code owners, listed in the CODEOWNERS file at the top-level of this repository.