apache / apache/pekko

Confusing sentence in Design Principles docs

Open
#1,740 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
Scala
Stars
1.6k
Forks
211
Avg merge
1d 6h
Merged PRs (30d)
89

Description

I know this is trivial, and 7 years old from the Akka fork, but I was perplexed by this sentence in the [Design Principles page](https://pekko.apache.org/docs/pekko/current/general/stream/stream-design.html): https://github.com/apache/pekko/blob/2469f729f7503acf814bcbd042b4bb0863103c9d/docs/src/main/paradox/general/stream/stream-design.md?plain=1#L56

I tried to parse my way through,
```
can
with certainty
it can't
really be that X
can be considered
P or
Q
```
and think I've landed on a qualifier-free simplification of, "A direct inheritance relationship with these types cannot be considered some sort of advantage nor meaningful differentiator between libraries."

Is that what this is trying to say? I acknowledge that qualifiers can be important, so that's why I'm not submitting a PR to use that new text, but I'm suggesting that someone who understands this better try to rephrase that sentence or paragraph so that it's easier to follow.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.