[riot-notifications] [RIOT-OS/RIOT] doc/rdm: RFC - design goals (#10162)
notifications at github.com
Thu Jan 24 16:40:13 CET 2019
Famous quote: "sorry I did not have time to make this shorter".
In this document we need to get to the point as quickly as possible, the point being: design philosophies/principles (do we agree on this?)
If we really want to *try* a detour through a list of (potential? actual?) uses cases *before* getting to the point, let this list be as short as possible.
I counted 40 bullet points in a row (?!). Attempting to read this, the audience thinks "difficult to digest, no idea where this is going", ends up skipping + less confident in the doc.
A crisp take-away message should be stated
and some rationale should become obvious
- why any listed use case / aspect is mentioned, and
- why *not* listing this use case / aspect would harm our message.
If we cannot do that in a satisfactory manner, we should move this list in appendix where it does not harm a candid reader before he/she gets to the crux of the document -- or let's drop this section altogether.
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the notifications