From f0bfc4d7033239ed93659208aa2b53d370c92784 Mon Sep 17 00:00:00 2001 From: Chris Holdgraf Date: Sun, 21 Aug 2022 07:19:35 +0200 Subject: [PATCH] DOCS: Add meeting minutes for April (#714) --- docs/meetings/2022.md | 61 +++++++++++++++++++++++++++++++++++++++ docs/team_panels_code.txt | 20 +++++++++++++ 2 files changed, 81 insertions(+) diff --git a/docs/meetings/2022.md b/docs/meetings/2022.md index bef8ad5..c1704d9 100644 --- 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 index 3434867..c5e256c 100644 --- 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