[riot-notifications] [RIOT-OS/RIOT] doc/rdm: RFC - design goals (#10162)

Emmanuel Baccelli 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...
URL: <http://lists.riot-os.org/pipermail/notifications/attachments/20190124/a095717b/attachment-0001.html>

More information about the notifications mailing list