Skip to content

Conversation

@kafitzgerald
Copy link
Contributor

This PR:

  • Adds a central glossary that lives in the Appendix, but can be referenced from anywhere and removes page specific glossaries.
  • Adds several additional abbreviations to the central configuration to fill that out a bit
  • Adds several links to external resources
  • Makes some minor editorial changes to "Why Python?"

Closes #569 and partially addresses #571 (central glossary)

More detailed notes / references:

  • Another option for handling a longer glossary could be to do something like this: https://book.the-turing-way.org/afterword/glossary/
  • MyST glossary, abbreviation, etc. docs here: https://mystmd.org/guide/glossaries-and-terms
  • There are some cases where we'll need to make a call on if we'd like to see an abbreviation, a glossary term, fancy Wikipedia link, external link, or some combination thereof. Personally, I think the Wikipedia links are quite nice for background info / definitions that are a little less central to the Pythia Foundations content, but they do override the abbreviation feature IIRC and not everything has a Wikipedia entry (e.g. NCL). There's probably also a threshold for overuse with those. Anyway, very much open to suggestions / preferences.

@review-notebook-app
Copy link

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@github-actions
Copy link

github-actions bot commented Dec 4, 2025

👋 Thanks for opening this PR! The Cookbook will be automatically built with GitHub Actions. To see the status of your deployment, click below.
🔍 Git commit SHA: b49ed14
✅ Deployment Preview URL: https://ProjectPythia.github.io/pythia-foundations/_preview/582

@kafitzgerald kafitzgerald marked this pull request as ready for review December 4, 2025 02:33
@kafitzgerald kafitzgerald requested a review from a team as a code owner December 4, 2025 02:33
@kafitzgerald kafitzgerald requested review from dopplershift and ktyle and removed request for a team December 4, 2025 02:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

EM JOSE Review - Foundations: Why Python?

1 participant