This shows you the differences between two versions of the page.
— |
design:20131218-notes [2013/12/19 16:32] (current) rsewikiadmin created |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | (No formal agenda) | ||
+ | 1. Talk about xml doc, particular seeing if we can get some help creating test cases to help answer documentation questions | ||
+ | reference work and lists (lists are very complex); just copying the definition from old spec is sufficient; | ||
+ | Julian to send what test cases are needed to the list; send test cases to Julian - text that can be pasted in to a document in an xml2rfc document | ||
+ | in the repo, there are examples in the test doc - maybe we should set up a sample document in the repo so that people can add things to a single test doc; Julian already has a huge test case document, but it tests many other things as well so might not be idea for this | ||
+ | |||
+ | |||
+ | 2. Some action on the rfc-i list re: v3 vocabulary, but not as much as I expected. | ||
+ | Notice the problems when working on docs, and so when not writing RFCs, not experiencing the pain. Hard to contribute without the pain driver. | ||
+ | RSE declares end of January to be the cut off date for the new documentation. | ||
+ | What about a v2 to v3 xslt? That depends on what kind of features we think about. | ||
+ | HF to send an encouragement for features in mid January, reminder at end of January, cut off input February 14. | ||
+ | |||
+ | XML for ASCII art defining packet diagrams - good idea? bad idea? would be nice to add to the XML spec if people think its a good idea. Joe agrees it is a good idea nd have has implemented it (see https:// | ||
+ | A tool that takes something more manipulable and produces XML from it that can be copied into a document. | ||
+ | This would have to be in the canonical document, the format people would use (alt text in HTML or the equiv for tables) | ||
+ | |||
+ | |||
+ | This proposal takes a human readable input and turns in to an ASCII output; why not an SVG output? | ||
+ | |||
+ | |||
+ | The pattern is that there is human readable people as alt text and either access inut for tooling that generates SVG. Should the input text be part of the canonical XML at the end? Yes. IF we get the tooling right, then people will write the text and the back end tooling will call the creation of the diagrams/ | ||
+ | |||
+ | |||
+ | POST TO WIKI | ||
+ | from Joe Hildebrand to Everyone: | ||
+ | https:// | ||
+ | from Ted Lemon to Everyone: | ||
+ | http:// | ||
+ | from Joe Hildebrand to Everyone: | ||
+ | https:// | ||
+ | from RjS to Everyone: | ||
+ | |||
+ | http:// | ||
+ | |||
+ | from Paul Hoffman to Everyone: | ||
+ | https:// | ||
+ | from Julian Reschke to Everyone: | ||
+ | |||
+ | http:// | ||
+ | |||
+ | |||
+ | |||
+ | HF to post notes from previous calls | ||
+ | |||
+ | 3. Nevil and SVG - what can we do to help? | ||
+ | Joe sent email earlier, so Nevil has enough to go on for now. | ||
+ | |||
+ | 4. Joe and the draft - need answer re: authorship. | ||
+ | Post to list as participant, | ||
+ | |||
+ | 7. regarding non-ASCII encoding. | ||
+ | |||
+ | 8. Draft Style Guide is (I think) just about finished collecting comments from the RPC. We've had some back-and-forth discussion on this over the last week or so. Paul and I have talked about whether this should be one, two, or more drafts (split apart what we have) given the implications some of the Guide has on tools and format (i.e., structure of the references, ordering and numbering (or lack thereof) of sections). |