Skip to content

Commit 888cd0e

Browse files
committed
Removed bad practices guide
1 parent 60c97af commit 888cd0e

File tree

8 files changed

+190
-218
lines changed

8 files changed

+190
-218
lines changed

get-started/about.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -131,8 +131,6 @@ In general, we always propose that approach:
131131
> 3. loosely coupled, coarse-grained subsystems with separate lifecycles
132132
> - **False** reasons are: distributed development, modularization, isolation, ... → there are well established and proven better ways to address these things, without the pain which comes with microservices.
133133
134-
[See also the anti pattern of *Microservices Mania*](bad-practices#microservices-mania) {.learn-more}
135-
136134

137135

138136
### Parallelized Workflows
@@ -349,7 +347,6 @@ Of course, we also make mistakes and errors in CAP, but ...
349347
- And this effect increases with steadily growing adoption of CAP that we see, ...
350348
- And with the open culture we established successfully, for example, **open issue reports** in GitHub, that is, the standard out there, instead of private support tickets — a relict of the past.
351349

352-
> Note that all of this is in contrast to code generators, where you can't fix code generated in the past → see also [*Avoid Code Generators*](bad-practices#code-generators) in the anti patterns guide.
353350

354351
### Minimized Lock-Ins
355352

@@ -378,7 +375,7 @@ Keeping pace with a rapidly changing world of volatile cloud technologies and pl
378375

379376
- AI provides tremendous boosts to productivity → for example:
380377
- **Coding Assists** → for example, by [GitHub Copilot](https://github.com/features/copilot) in `.cds`, `.js`, even `.md` sources
381-
- **Code Analysis** → detecting [bad practices](bad-practices) → guiding to [best practices](best-practices)
378+
- **Code Analysis** → detecting bad practices → guiding to [best practices](best-practices)
382379
- **Code Generation** → for example, for tests, test data, ...
383380
- **Project Scaffolding** → for quick head starts
384381
- **Search & Learning Assists** → like SAP Joule, ...

get-started/bad-practices.md

Lines changed: 0 additions & 196 deletions
This file was deleted.

get-started/best-practices.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -280,7 +280,6 @@ Don't confuse CAP services with Microservices:
280280

281281
CAP services are important for how you *design* and *implement* your applications in clean and modularized ways on a fine-granular use case-oriented level. The primary focus of Microservices is on how to cut your whole application into independent coarse-grained(!) deployment units, to release and scale them independently.
282282

283-
[Learn more about that in the *Anti Patterns* section on Microservices](bad-practices#microservices-mania) {.learn-more}
284283

285284
## Events
286285

@@ -636,7 +635,6 @@ Not only do we address the very same goals, we can also identify several symmetr
636635
>
637636
> CAP is very much in line with both, the intent and goals of Hexagonal Architecture, as well as with the fundamental concepts. Actually, CAP *is an implementation* of Hexagonal Architecture, in particular with respect to the [*Adapters*](#protocol-adapters) in the outer hexagon, but also regarding [*Application Models*](#application-domain) and [*(Core) Domain Models*](#application-domain) in the inner hexagon.
638637
639-
[Also take notice of the *Squared Hexagons* section in the Anti Patterns guide](bad-practices#squared-hexagons) {.learn-more}
640638

641639

642640

get-started/index.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -155,8 +155,7 @@ After the [initial setup](#setup), we recommend continuing as follows while you
155155
| 1 | [Introduction – What is CAP?](about) | Learn about key benefits and value propositions. |
156156
| 2 | [Bookshop by capire](in-a-nutshell) | Build your first CAP application within 4-44 minutes. |
157157
| 3 | [Best Practices](best-practices) | Key concepts & rationales to understand → *must read*. |
158-
| 4 | [Anti Patterns](bad-practices) | Misconceptions & bad practices to avoid → *must read*. |
159-
| 5 | [Learn More](learning-sources) | Find samples, videos, blogs, tutorials, and so on. |
158+
| 4 | [Learn More](learn-more) | Find samples, videos, blogs, tutorials, and so on. |
160159
161160
162161
@@ -173,4 +172,4 @@ After these getting started-level introductions, you would continuously revisit
173172
| 10 | [Resources](/resources/) | About support channels, community, ... |
174173
175174
176-
This also reflects the overall structure of [this documentation](./learning-sources.md#this-documentation).
175+
This also reflects the overall structure of [this documentation](./learn-more#this-documentation).

0 commit comments

Comments
 (0)