[rssac-caucus] Errata for RSSAC-002 (example YAML indentation)
The RSSAC-002 document describes using the YAML format for the data files. An example YAML file is given for each metric. Unfortunately, two of the examples given are not valid YAML. The traffic-volume and unique-sources have incorrect example YAML files. The lines after the "metric" line are indented, but they should not be indented. INCORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: traffic-volume dns-udp-queries-received-ipv4: 31272 dns-udp-queries-received-ipv6: 11211 dns-tcp-queries-received-ipv4: 12 dns-tcp-queries-received-ipv6: 2 dns-udp-responses-sent-ipv4: 131079 dns-udp-responses-sent-ipv6: 16833 dns-tcp-responses-sent-ipv4: 94 dns-tcp-responses-sent-ipv6: 7 CORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: traffic-volume dns-udp-queries-received-ipv4: 31272 dns-udp-queries-received-ipv6: 11211 dns-tcp-queries-received-ipv4: 12 dns-tcp-queries-received-ipv6: 2 dns-udp-responses-sent-ipv4: 131079 dns-udp-responses-sent-ipv6: 16833 dns-tcp-responses-sent-ipv4: 94 dns-tcp-responses-sent-ipv6: 7 INCORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: unique-sources num-sources-ipv4: 2086125 num-sources-ipv6: 42941 num-sources-ipv6-aggregate: 3873 CORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: unique-sources num-sources-ipv4: 2086125 num-sources-ipv6: 42941 num-sources-ipv6-aggregate: 3873 DW
Hello List. Nice catch Duane... unfortunately I'm (was) not aware of the YAML format (I usually work with csv and json). But anyway IMHO your comment is fully valid. As ex-DL I don't know if the errata should be published immediately or wait for something else, second version, just an errata version or something like this. Anyway my support to your comment. Regards, Alejandro, El 8/20/2015 a las 2:33 PM, Wessels, Duane escribió:
The RSSAC-002 document describes using the YAML format for the data files. An example YAML file is given for each metric. Unfortunately, two of the examples given are not valid YAML. The traffic-volume and unique-sources have incorrect example YAML files. The lines after the "metric" line are indented, but they should not be indented.
INCORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: traffic-volume dns-udp-queries-received-ipv4: 31272 dns-udp-queries-received-ipv6: 11211 dns-tcp-queries-received-ipv4: 12 dns-tcp-queries-received-ipv6: 2 dns-udp-responses-sent-ipv4: 131079 dns-udp-responses-sent-ipv6: 16833 dns-tcp-responses-sent-ipv4: 94 dns-tcp-responses-sent-ipv6: 7
CORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: traffic-volume dns-udp-queries-received-ipv4: 31272 dns-udp-queries-received-ipv6: 11211 dns-tcp-queries-received-ipv4: 12 dns-tcp-queries-received-ipv6: 2 dns-udp-responses-sent-ipv4: 131079 dns-udp-responses-sent-ipv6: 16833 dns-tcp-responses-sent-ipv4: 94 dns-tcp-responses-sent-ipv6: 7
INCORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: unique-sources num-sources-ipv4: 2086125 num-sources-ipv6: 42941 num-sources-ipv6-aggregate: 3873
CORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: unique-sources num-sources-ipv4: 2086125 num-sources-ipv6: 42941 num-sources-ipv6-aggregate: 3873
DW
_______________________________________________ rssac-caucus mailing list rssac-caucus@icann.org https://mm.icann.org/mailman/listinfo/rssac-caucus
Indeed, perhaps a document shepherd should track such things. On Thu, 20 Aug 2015, Alejandro Acosta wrote:
Hello List. Nice catch Duane... unfortunately I'm (was) not aware of the YAML format (I usually work with csv and json). But anyway IMHO your comment is fully valid. As ex-DL I don't know if the errata should be published immediately or wait for something else, second version, just an errata version or something like this.
Anyway my support to your comment.
Regards, Alejandro,
El 8/20/2015 a las 2:33 PM, Wessels, Duane escribi?:
The RSSAC-002 document describes using the YAML format for the data files. An example YAML file is given for each metric. Unfortunately, two of the examples given are not valid YAML. The traffic-volume a nd unique-sources have incorrect example YAML files. The lines after the "metric" line are indented, but they sho uld not be indented.
INCORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: traffic-volume dns-udp-queries-received-ipv4: 31272 dns-udp-queries-received-ipv6: 11211 dns-tcp-queries-received-ipv4: 12 dns-tcp-queries-received-ipv6: 2 dns-udp-responses-sent-ipv4: 131079 dns-udp-responses-sent-ipv6: 16833 dns-tcp-responses-sent-ipv4: 94 dns-tcp-responses-sent-ipv6: 7
CORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: traffic-volume dns-udp-queries-received-ipv4: 31272 dns-udp-queries-received-ipv6: 11211 dns-tcp-queries-received-ipv4: 12 dns-tcp-queries-received-ipv6: 2 dns-udp-responses-sent-ipv4: 131079 dns-udp-responses-sent-ipv6: 16833 dns-tcp-responses-sent-ipv4: 94 dns-tcp-responses-sent-ipv6: 7
INCORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: unique-sources num-sources-ipv4: 2086125 num-sources-ipv6: 42941 num-sources-ipv6-aggregate: 3873
CORRECT: --- service: j.root-servers.net start-period: '2013-08-26T00:00:00Z' end-period: '2013-08-26T23:59:59Z' metric: unique-sources num-sources-ipv4: 2086125 num-sources-ipv6: 42941 num-sources-ipv6-aggregate: 3873
DW
_______________________________________________ rssac-caucus mailing list rssac-caucus@icann.org https://mm.icann.org/mailman/listinfo/rssac-caucus
participants (3)
-
Alejandro Acosta -
Wessels, Duane -
William Sotomayor