From 40dd64ac5d46106993367b435f02ee348994ed7e Mon Sep 17 00:00:00 2001 From: Rowan Cockett Date: Thu, 6 Oct 2022 22:58:50 -0600 Subject: [PATCH 1/3] =?UTF-8?q?=F0=9F=91=8B=20Welcome=20page?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- profile/README.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 profile/README.md diff --git a/profile/README.md b/profile/README.md new file mode 100644 index 0000000..a5ecb40 --- /dev/null +++ b/profile/README.md @@ -0,0 +1,28 @@ +# Executable Books + +The Executable Books Project is an international collaboration to build open source tools that facilitate publishing computational narratives using the Jupyter ecosystem. + +We are a community who steward: + +- [Jupyter Book](https://jupyterbook.org): Build beautiful, publication-quality books and documents from computational material like Jupyter Notebooks. +- [MyST Markdown](https://myst.tools): An extended Markdown format designed for the future of technical communication and publication. + +As well as many, many other tools for parsing, headless execution of Jupyter Notebooks ([caching](https://github.com/executablebooks/jupyter-cache) and in the [browser](https://github.com/executablebooks/thebe)), popular sphinx extensions (e.g. [copy-button](https://github.com/executablebooks/sphinx-copybutton), [sphinx-design](https://github.com/executablebooks/sphinx-design), [sphinx-thebe](https://github.com/executablebooks/sphinx-thebe)), and many [scientific templates](https://github.com/myst-templates) for writing journal articles and presentations. + +## Contribute to a Project πŸ‘©β€πŸ’» + +[Ask a question](https://github.com/orgs/executablebooks/discussions) or [show and tell](https://github.com/orgs/executablebooks/discussions/categories/show-and-tell) the community about your project or use of MyST, or come to a [monthly team meeting](https://executablebooks.org/en/latest/meetings/index.html). + +All of our projects are open source and welcome and and all contributions -- from documenting problems you run into, adding to documentation, [telling people](https://twitter.com/executablebooks) about your project and our mission, and _of course_ contributing to the code! Please review our [Code of Conduct](../CODE_OF_CONDUCT.md) to learn about some of the conventions we follow. + +## Be inspired, build a book βœ¨πŸ“–βœ¨ + +Our [Gallery of Jupyter Books](https://executablebooks.org/en/latest/gallery.html) has contributions from across the community. See the [Jupyter Book documentation](https://jupyterbook.org/en/stable/intro.html) to get up and running to create your first online book, with executable, interactive content. + +## Learn about MyST Markdown βœοΈπŸ‘©β€πŸ”¬ + +Visit to see an interactive demo of working with MyST -- an extensible and powerful markup language for technical writing. You can use it to [create books](https://jupyterbook.org/), write [scientific papers](https://js.myst.tools/guide/creating-pdf-documents), or use [MyST in JupyterLab](https://github.com/executablebooks/jupyterlab-myst). + +## About the project ℹ️ + +Learn more about our project’s [goals and strategy](https://executablebooks.org/en/latest/about.html), see a list of core [team members](https://executablebooks.org/en/latest/team.html), and come to our [next team meeting](https://executablebooks.org/en/latest/meetings/index.html). From 1b40b4e86feacc3cfc440c2886c9b4b35a2fd9b8 Mon Sep 17 00:00:00 2001 From: Rowan Cockett Date: Thu, 15 Jun 2023 15:34:40 -0700 Subject: [PATCH 2/3] Update to mystmd.org See executablebooks/team-compass#21 --- profile/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/profile/README.md b/profile/README.md index a5ecb40..d46caaa 100644 --- a/profile/README.md +++ b/profile/README.md @@ -5,7 +5,7 @@ The Executable Books Project is an international collaboration to build open sou We are a community who steward: - [Jupyter Book](https://jupyterbook.org): Build beautiful, publication-quality books and documents from computational material like Jupyter Notebooks. -- [MyST Markdown](https://myst.tools): An extended Markdown format designed for the future of technical communication and publication. +- [MyST Markdown](https://mystmd.org): An extended Markdown format designed for the future of technical communication and publication. As well as many, many other tools for parsing, headless execution of Jupyter Notebooks ([caching](https://github.com/executablebooks/jupyter-cache) and in the [browser](https://github.com/executablebooks/thebe)), popular sphinx extensions (e.g. [copy-button](https://github.com/executablebooks/sphinx-copybutton), [sphinx-design](https://github.com/executablebooks/sphinx-design), [sphinx-thebe](https://github.com/executablebooks/sphinx-thebe)), and many [scientific templates](https://github.com/myst-templates) for writing journal articles and presentations. @@ -21,7 +21,7 @@ Our [Gallery of Jupyter Books](https://executablebooks.org/en/latest/gallery.htm ## Learn about MyST Markdown βœοΈπŸ‘©β€πŸ”¬ -Visit to see an interactive demo of working with MyST -- an extensible and powerful markup language for technical writing. You can use it to [create books](https://jupyterbook.org/), write [scientific papers](https://js.myst.tools/guide/creating-pdf-documents), or use [MyST in JupyterLab](https://github.com/executablebooks/jupyterlab-myst). +Visit to see an interactive demo of working with MyST -- an extensible and powerful markup language for technical writing. You can use it to [create books](https://jupyterbook.org/), write [scientific papers](https://mystmd.org/guide/creating-pdf-documents), or use [MyST in JupyterLab](https://github.com/executablebooks/jupyterlab-myst). ## About the project ℹ️ From fa87dbaf7347ded0c243281f3da1097f38105cbe Mon Sep 17 00:00:00 2001 From: Rowan Cockett Date: Thu, 15 Jun 2023 16:35:13 -0600 Subject: [PATCH 3/3] Update profile/README.md Co-authored-by: Chris Holdgraf --- profile/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/profile/README.md b/profile/README.md index d46caaa..0954f60 100644 --- a/profile/README.md +++ b/profile/README.md @@ -7,7 +7,7 @@ We are a community who steward: - [Jupyter Book](https://jupyterbook.org): Build beautiful, publication-quality books and documents from computational material like Jupyter Notebooks. - [MyST Markdown](https://mystmd.org): An extended Markdown format designed for the future of technical communication and publication. -As well as many, many other tools for parsing, headless execution of Jupyter Notebooks ([caching](https://github.com/executablebooks/jupyter-cache) and in the [browser](https://github.com/executablebooks/thebe)), popular sphinx extensions (e.g. [copy-button](https://github.com/executablebooks/sphinx-copybutton), [sphinx-design](https://github.com/executablebooks/sphinx-design), [sphinx-thebe](https://github.com/executablebooks/sphinx-thebe)), and many [scientific templates](https://github.com/myst-templates) for writing journal articles and presentations. +As well as many other tools for parsing, headless execution of Jupyter Notebooks ([caching](https://github.com/executablebooks/jupyter-cache) and in the [browser](https://github.com/executablebooks/thebe)), popular sphinx extensions (e.g. [copy-button](https://github.com/executablebooks/sphinx-copybutton), [sphinx-design](https://github.com/executablebooks/sphinx-design), [sphinx-thebe](https://github.com/executablebooks/sphinx-thebe)), and many [scientific templates](https://github.com/myst-templates) for writing journal articles and presentations. ## Contribute to a Project πŸ‘©β€πŸ’»