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

Thomas C. Schmidt notifications at github.com
Thu Jan 24 12:34:07 CET 2019


> So I propose going back to the (tried and tested) format that Django has followed. Specifically: 
>     * Remove use cases section and raise this as a separate PR later (with synthesis and analysis as proposed above)
> 
>     * Reduce intro and abstract to be shorter as described above
> 
> 
> Reducing the scope would also make the document easier to review and achieve consensus around.
> 
> @emmanuelsearch @tcschmidt in particular (since you've been reviewing so far) would you be happy for us to proceed like this?

Nope. This document does not converge because it oscillates way too much. E.g., we had this discussion about the use case section in October and there was a clear outcome to leave them in. The rationale: If such a document has too little to say, it is not needed at all. 

The same problem is with many contributions (as discussed offline in Dec): If they are not well and exhaustively assembled (on a well-defined level of abstraction), or if they are not crisply clear stated, then the document carries little weight and does not help the reader.  

So I agree with @emmanuelsearch: A document that starts an abstract with 
> Although several papers have been published that give a broad technical overview of RIOT ...

will raise little interest and undermines its own value.
I will try to do a detailed review later, but my overall impression is that we had been on a pretty good level of convergence in October (aside from the technical discussions raised, which were not to be part of the document), and are drifting partly sidewards, partly away since then. 

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/RIOT-OS/RIOT/pull/10162#issuecomment-457165821
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.riot-os.org/pipermail/notifications/attachments/20190124/ba19b5cd/attachment.html>


More information about the notifications mailing list