Skip to content

Commit 8ca95ae

Browse files
binjiMs2ger
andauthored
Add notes for WG-03-11 (#519)
* Add notes for WG-03-11 * Update 2020/WG-03-11.md Co-Authored-By: Ms2ger <[email protected]> Co-authored-by: Ms2ger <[email protected]>
1 parent 2ea9e5c commit 8ca95ae

File tree

1 file changed

+70
-1
lines changed

1 file changed

+70
-1
lines changed

2020/WG-03-11.md

Lines changed: 70 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,4 +48,73 @@ None.
4848

4949
## Meeting Notes
5050

51-
Added after meeting.
51+
### Introduction of attendees
52+
53+
* Ben Smith
54+
* Ms2ger
55+
* Luke Wagner
56+
57+
### POLL: [standardize phase 4 proposals](https://github.com/webassembly/proposals#phase-4---standardize-the-feature-wg)
58+
59+
1. [Non-trapping float to int](https://github.com/WebAssembly/nontrapping-float-to-int-conversions)
60+
61+
1. [Sign-extension operators](https://github.com/WebAssembly/sign-extension-ops)
62+
63+
1. [Multi-value](https://github.com/WebAssembly/multi-value)
64+
65+
We discussed how best to advance from phase 4 to phase 5. Because of the low
66+
attendance of this meeting, we decided to send out an email to the WG mailing
67+
list instead of polling the group.
68+
69+
We discussed that we should probably make a set of PRs for each proposal before
70+
sending the email out, so the group can see what they'd be agreeing to merge,
71+
and if there are any merge issues. It also requires us to linearize the set of
72+
proposals, which may be desirable.
73+
74+
AI(binji): Make a PR against the spec for each proposal.
75+
76+
AI(binji): Send out email to WG asking for approval to merge PRs
77+
78+
### Discussion: new spec document design (Ben Smith + Eric Prud'hommeaux)
79+
80+
Ben presented to the group. The current core spec document is generated in a
81+
convoluted way (Restructured text, to single-page HTML, extracting MathJax and
82+
converting to Katex, python scripts, Bikeshed). This is not a maintainable
83+
solution. Ben Smith, Eric Prud'hommeaux, and Philippe Le Hégaret had a meeting
84+
to discuss improvements to this process a month ago. For the most part this
85+
process was done to ensure that the mathematics snippets in the document were
86+
renderable without JavaScript (which MathJax requires). However, since we can
87+
already produce a PDF from the spec document source, this would fit the
88+
requirement of having a non-JavaScript version of the document. We can then use
89+
the standard multi-page HTML w/ MathJax document as the main spec document.
90+
91+
This would require some changes to both documents to include the required W3C
92+
layout and front matter, but would be significantly less work than we are doing
93+
currently.
94+
95+
In general, the group seemed to think this was a good direction to go, though
96+
Ms2ger did mention that it was annoying that the document reflowed when the
97+
MathJax finally loaded. The group agreed. It also seems that perhaps the
98+
feature detection for MathJax is not quite right, since it doesn't detect that
99+
Firefox can render MathML, and says that MathML is not available if you try to
100+
choose it in the settings.
101+
102+
Ben also mentioned that we were considering moving to using the W3C's new
103+
living document process. It would be a better fit for WebAssembly in many ways,
104+
since it doesn't require going through the entire REC process. However, as far
105+
as we know, no other group has adopted this process yet, so there was some
106+
hesitation from the group. We discussed that perhaps if someone from the W3 was
107+
able to help us through the process, it might make it easier for us to make
108+
this decision.
109+
110+
AI(binji): Follow up on living document
111+
112+
### Discussion: go offline for most meetings
113+
114+
Because of low attendance of this meeting, we discussed having more decisions
115+
made asynchronously over email. We weren't exactly sure the correct email
116+
address for the WG mailing list.
117+
118+
AI(binji): Find email for WG mailing list
119+
120+
## Closure

0 commit comments

Comments
 (0)