Examples - Editorial

[Patrick Durusau <patrick@durusau.net>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Greetings!

I wanted to make a general comment on all examples in TOSCA and
thought the one at lines 516 - 526, inclusive, would be a good one.

How many people think an implementer of a TOSCA implementation will be
assisted by a "hello world" example written in TOSCA XML?

That's what I suspected.

For all the other examples, I think the test needs to be: Does this
example help you understand some thing difficult or unclear about the
specification?

If not, why have it in the specification?

Hope everyone is having a great day!

Patrick
- -- 
Patrick Durusau
patrick@durusau.net
Technical Advisory Board, OASIS (TAB)
Former Chair, V1 - US TAG to JTC 1/SC 34
Convener, JTC 1/SC 34/WG 3 (Topic Maps)
Editor, OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300
Co-Editor, ISO/IEC 13250-1, 13250-5 (Topic Maps)

Another Word For It (blog): http://tm.durusau.net
Homepage: http://www.durusau.net
Twitter: patrickDurusau
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQIcBAEBAgAGBQJSJh/DAAoJEAudyeI2QFGoHEUQALjg9GthlHfK7Vc2DSl6usYF
TW+jAaWustkCQD4ZOeLMouiGHMhp2mTCneubrqYbgyx5uqL2tko5pB1AZvPT187w
zJCJLATgWt89AB3UNm8V7B6WmcEffl6hOftPuqGOJfREjcpiEB4S4vPnXlHCmEqJ
Ro9wZsdX+MY3P3Pc6wSCfmVVorzHEOsOtapRMq7UtmvlZSP2eQyDlNWroxCEqccL
UVb3wFcxqQFOGdrrIoZYsw0mZXmU/A/XOeL4TIxlCpMgA/E/h5LDAqi78Sp9yk+r
ZdauXvqbILpc5dc0JFsOxcLYWNVmcW0K7/ccRn8IUp994biTkF38RXJhXr+Mk+Wq
5Mzmkw0rmBhpbhRgY1eYundSx5+M4VVgQyV5YsWLrZi+qc4I8RRryVVyMqKD9vP8
gy+U0RH2CeDf2iNhIi1XPfkj1Aw9iZ1sLyPIfmcv7pEzAFN1Lg2pEsgFhtRG/r8M
DyXzbbAlJUgxi9kZ37wNTQB39xcSlTSbuRsHBo+c24ec89WdBKH6t2MfhmbUE7++
od75d+avOVLCuhwHJc3gbX8eRQkTmAM+7e835Fl3WP4UTONgfUu7c/J7wvsIMkAH
2Sy2WEr/nmQXKUrrOjkVYZnapU+T9fTNejGddIK2SMqH2W52igs6DmaaJe/NSEqZ
vZhq3QfFQUNpeFyhCF2X
=G9c8
-----END PGP SIGNATURE-----