Pythonedu-wg September 2021

pythonedu-wg@python.org

5 participants
3 discussions

Work Group Members
by Betsy Waliszewski 02 Dec '21

02 Dec '21

Hi, Can you add a list of your members to the wiki page: https://wiki.python.org/psf/PythonEduWG? We've had several requests from people wanting to upgrade their membership and they list themselves as education work group members. I just want to confirm that they are members. I think there is some confusion in the form about the field "Project(s) or Working Group(s)". Some people may interpret it as "I have an interest in . . ." rather than "I'm a member currently working in the . . .". Thanks for your help. Betsy -- Betsy Waliszewski *Pronouns: she/her/hers* Event Planner / Sponsorship Coordinator @ThePSF As a non-profit organization, the PSF depends on sponsorships and donations to support the Python community. Check out our Annual Impact Report for more details: https://www.python.org/psf/annual-report/2019/ Please contribute to the PSF; we can't continue our work without your support! https://www.python.org/psf/donations/

4 3

Introduction
by Aditya Bholah 23 Oct '21

23 Oct '21

Hello all, I am Aditya, a junior data analyst in Mauritius and also recently registered myself as a managing member at PSF. I have been using Python for a very long time as my primary programming language for both work and personal projects. I would love to contribute in any way possible to the Python Project and help inspire more people to know about the project and what PSF does. It would be great if anyone and let me know how can I help in this working group. Cheers From Mauritius, [image: photo] *Aditya Bholah* Junior Data Analyst, LSL Digital, La Sentinelle Ltd. (+230) 2068581 <(+230)+2068581> | (+230) 57587306 <(+230)+57587306> | aditya(a)lsl.digital www.lsl.digital Rue Des Oursin, Tombeau Bay, Mauritius , Indian Ocean <https://www.facebook.com/aditya.bholah07> <https://www.linkedin.com/in/rishikesh-bholah-91b8b3137/> <https://twitter.com/aditya_bholah> <https://www.instagram.com/aditya.bholah/>

11 12

RFC: New/update the Docs Sphinx theme: responsive, edit page links,
by Wes Turner 24 Sep '21

24 Sep '21

Where would be the best place to discuss or just improve the CPython docs sphinx theme? What would Python need in a {PyData,} Sphinx theme fork: - [ ] ENH: add <edit on github> links to every docs page - [ ] ENH: responsive breakpoints for mobile devices - [ ] ENH: responsive fonts - [ ] ENH: toggle-able dark theme - [ ] ENH: interactive code examples (in WASM with pyodide like JupyterLite) - [ ] ENH?: Two sidebars: {Global TOC} {Content} {Document TOC} The PyData theme [bandwagon, feature justification, maintenance burden justification] Src: https://github.com/pydata/pydata-sphinx-theme Docs: https://pydata-sphinx-theme.readthedocs.io/en/latest/ ```quote Other sites that are using this theme: - Pandas: https://pandas.pydata.org/docs/ - NumPy: https://numpy.org/doc/stable/ - SciPy: https://scipy.github.io/devdocs/ - NetworkX: https://networkx.org/documentation/latest/ - Bokeh: https://docs.bokeh.org/en/latest/ - JupyterHub and Binder: https://docs.mybinder.org/, http://z2jh.jupyter.org/en/latest/, https://repo2docker.readthedocs.io/en/latest/, https://jupyterhub-team-compass.readthedocs.io/en/latest/ - Jupyter Book beta version uses an extension of this theme: https://beta.jupyterbook.org - Fairlearn: https://fairlearn.org/main/about/ ``` The sphinx-book-theme theme (Jupyter Book theme) has a few possibly necessary features for the {CPython, Devguide, *} docs: https://github.com/executablebooks/sphinx-book-theme https://sphinx-book-theme.readthedocs.io/en/latest/ :: ```quote A Sphinx theme with a clean design, support for interactive content, and a modern book-like look and feel. Flexible content layout: Inspired by beautiful online books, such as the Edward Tufte CSS guide Visual classes designed for Jupyter Notebooks: Cell inputs, outputs, and interactive functionality are all supported. Launch buttons for online interactivity: For pages that are built with computational material, connect your site to an online BinderHub for interactive content. Bootstrap 4: To style visual elements and add functionality. International: All text integrated in the theme is translated to the specified Sphinx language. ``` https://github.com/python/cpython/blob/main/Doc/conf.py#L68 : ```python html_theme = 'python_docs_theme' ``` https://github.com/python/cpython/blob/main/Doc/requirements.txt#L12 ``` # The theme used by the documentation is stored separately, so we need # to install that as well. python-docs-theme ``` Pypi: https://pypi.org/project/python-docs-theme/ Src: https://github.com/python/python-docs-theme/ What are some better ways to add {Source RST, Source, Edit, History, and Annotate} links to every sphinx doc page than sphinxcontrib-srclinks? https://github.com/westurner/sphinxcontrib-srclinks#usage - sphinxcontrib-srclinks: Source RST, Source, Edit, History, and Annotate, Clone URL - [ ] copy clone URL to clipboard button - pydata-theme: 'Edit this page' on the document TOC sidebar - sphinx-book-theme: {gh, bb, gl} icon > 'Suggest edit' - [ ] ENH: add collapsible sidebar to whatever is chosen as a suitable replacement for the current non-responsive theme

2 1

2022

2021

2020

2019

2018

2017

2016

2015

Pythonedu-wg September 2021