- From: Rob Atkinson via GitHub <sysbot+gh@w3.org>
- Date: Fri, 26 Nov 2021 00:30:01 +0000
- To: public-dxwg-wg@w3.org
+1 to providing the link in the README Accept that human readability of examples requires careful consideration. Developers are human too and examples tend to be a quick way of seeing how things are done - so taking care not to promote sub-optimal implementation patterns is important. For a complete file, probably better to have a complete example - including a reusable context link. For "snippet" examples obviously not meant to be runnable, only human readable, perhaps have the snippet in two very simple parts - a context snippet and a code snippet. By the time you refer someone to a complete example I think people will expect implementation patterns. -- GitHub Notification of comment by rob-metalinkage Please view or discuss this issue at https://github.com/w3c/dxwg/issues/1428#issuecomment-979542863 using your GitHub account -- Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config
Received on Friday, 26 November 2021 00:30:03 UTC