- From: Anssi Kostiainen via GitHub <sysbot+gh@w3.org>
- Date: Thu, 12 Feb 2015 09:05:55 +0000
- To: public-secondscreen@w3.org
I agree with @mfoltzgoogle in that we should include smaller code snippers in the Example section, and eliminate the prose as it becomes redundant. Optimally, the API is self-documenting to the extend no extensive developer documentation is needed to understand otherwise well-documented example code. I will unassign myself from this issue, since I think this would be a good first issue for someone new to take who'd like to contribute to the Example section directly. All - Feel free to assign this issue to yourself, if you'd like to help with this issue in the near future. Writing code examples against the API and keeping them up to date as the API evolves is a good practise as it prevents surprises with developer ergonomics, helps identify functional issues and spec bugs before the actual implementation feedback is received. -- GitHub Notif of comment by anssiko See https://github.com/w3c/presentation-api/issues/42#issuecomment-74038530
Received on Thursday, 12 February 2015 09:06:04 UTC