DOCS: Add meeting minutes for April (#714)

executablebooks · Aug 21, 2022 · f0bfc4d · f0bfc4d
1 parent 87cfdd6
commit f0bfc4d
Show file tree

Hide file tree

Showing 2 changed files with 81 additions and 0 deletions.
diff --git a/docs/meetings/2022.md b/docs/meetings/2022.md
@@ -1,5 +1,66 @@
 # 2022
 
+## April
+
+### Atending
+
+- Matthew McKay / ANU / mmcky
+- Rowan Cockett / Curvenote / rowanc1
+- Chris Sewell / EPFL / chrisjsewell
+- Chris Holdgraf / 2i2c / choldgraf
+- Damián Avila / 2i2c / damianavila
+- Aakash Gupta / ANU / aakashgc
+
+### Notes
+
+- `myst-spec` - @fwkoch, @rowanc1, @chrisjsewell
+  - over the past month, we've put together a language-agnostic repo of JSON schema types for the MyST AST nodes, building on existing `mdast` types.
+    - github: https://github.com/executablebooks/myst-spec
+    - dist: https://unpkg.com/browse/myst-spec/dist/
+  - This also includes test cases, similar to the commonmark spec, which may be used to validate implementations of the spec
+  - `mystjs`, the markdown-it javascript implementation, already consumes myst spec
+  - [`unified-myst`](https://github.com/executablebooks/unified-myst), the new unified ecosystem implementation, will also be "spec compliant"!
+  - python side hasn't been adressed quite yet.
+- [Unified MyST](https://github.com/executablebooks/unified-myst)
+  - There are some drawbacks of markdown-it
+    - It doesn't have a well specified AST
+    - myst-spec uses `mdast`, but that's a "unified ecosystem" thing, not a markdown-it thing
+  - Unified ecosystem has their own parser called [micromark](https://github.com/micromark/micromark) (and that is bundled in [remark](https://remarkjs.com/))
+  - The [unified-myst](https://github.com/executablebooks/unified-myst) parser uses this framework instead of markdown-it
+  - Q: **What's the relationship between all of these parsers?**
+    - MyST-js would use the unified parser
+    - VSCode uses markdown-it-docutils (not even mystjs)
+    - Unified ecosystem is well-maintained with many extensions
+  - Q: **how do all of these pieces fit together for the end-user experience?**
+    - We should have a strategy meeting about the direction of these pieces so that we can align on a path forward.
+    - There is not currently a "product" at the end that is driving all of this forward (from an end-user's perspective).
+  - Q: **This seems like a lot of stuff to maintain. How can we sustain our efforts?**
+    - We have a bunch of stuff we've added to grow our maintenance burden.
+    - Can we tie the JS myst stuff to end-users in a way that we can fund?
+    - General agreement that we need a better story around the strategy and maintainability of this stack.
+  - Product strategy meeting?
+    - Bring in multiple stakeholders around a "product vision / strategy" for where the ecosystem could move going forward.
+    - Could we bring the learnings from the JS world back into the Python world to improve Jupyter Book.
+- Curvenote renderer for multiple composable "JupyterBooks"
+  - Hosting a conference at end of April!
+  - https://transform.softwareunderground.org/
+- CH: New book theme is out, will update Jupyter Book to use it soon!
+
+**Note: we did not get to the following topics, but there are some notes**
+
+- [Gated Directives (sphinx-exercise)](https://ebp-sphinx-exercise.readthedocs.io/en/latest/syntax.html#alternative-gated-syntax). There has been some comments and interest in making this syntax more general so it could be used for other directives.
+  - Best Strategy? As an extension?
+  - Mention this with work being done on `myst-spec`
+- First Developer Interview: "Deep Dive into Parsing" (with Chris Sewell)
+  - https://github.com/executablebooks/meta/issues/672#issue-1147568262
+  - cover myst-parser, markdown-it-py
+  - Any questions? Please add it to the issue.
+  - Will post a recording to share more widely.
+- JupyterLab Myst Extension as you go
+  - Editing experience in jupyter is very critical!
+- MyST Docs
+  - New repository? Migrate and refurbish content?
+
 ## March
 
 ### Attending

diff --git a/docs/team_panels_code.txt b/docs/team_panels_code.txt
@@ -73,6 +73,26 @@
 ````
 
 
+````{grid-item}
+```{image} https://avatars.githubusercontent.com/u/913249?v=4
+:height: 150px
+:alt: avatar
+:target: https://github.com/rowanc1
+:class: sd-rounded-circle
+```
+````
+
+
+````{grid-item}
+```{image} https://avatars.githubusercontent.com/u/1473646?v=4
+:height: 150px
+:alt: avatar
+:target: https://github.com/stevejpurves
+:class: sd-rounded-circle
+```
+````
+
+
 ````{grid-item}
 ```{image} https://avatars.githubusercontent.com/u/6542997?v=4
 :height: 150px