diff --git a/.ai-sessions/lessons.md b/.ai-sessions/lessons.md new file mode 100644 index 0000000..97b920e --- /dev/null +++ b/.ai-sessions/lessons.md @@ -0,0 +1,16 @@ +# Lessons Learned + +## Recent + +- meetup.com returns HTTP 200 and a generic page title for nonexistent group URLs; confirm group URLs with Mason or the Meetup Pro page data instead of curl status codes (2026-09-29) +- mkdocs-redirects generates redirect pages without a stub source file; deleting a page and adding it to `redirect_maps` is enough (2026-09-29) +- The Meetup Pro network page at meetup.com/pro/pytexas only shows active groups; inactive but still-supported groups like Katy Python Coders won't appear (2026-09-29) +- Board minutes and officer elections live in the PyTexas shared Drive as "YYYY-MM-DD Annual Meeting" docs; search there before asking Mason for officer terms (2026-09-29) + +## Tooling +- mkdocs-redirects generates redirect pages without a stub source file; deleting a page and adding it to `redirect_maps` is enough (2026-09-29) +- meetup.com returns HTTP 200 and a generic page title for nonexistent group URLs; confirm group URLs with Mason or the Meetup Pro page data instead of curl status codes (2026-09-29) + +## Documentation +- The Meetup Pro network page at meetup.com/pro/pytexas only shows active groups; inactive but still-supported groups like Katy Python Coders won't appear (2026-09-29) +- Board minutes and officer elections live in the PyTexas shared Drive as "YYYY-MM-DD Annual Meeting" docs; search there before asking Mason for officer terms (2026-09-29) diff --git a/.ai-sessions/session-20260929-1943-stale-page-audit.md b/.ai-sessions/session-20260929-1943-stale-page-audit.md new file mode 100644 index 0000000..1fc2da1 --- /dev/null +++ b/.ai-sessions/session-20260929-1943-stale-page-audit.md @@ -0,0 +1,58 @@ +# Session Summary: Stale Page Audit and Updates + +**Date**: 2026-09-29 +**Duration**: ~1 hour +**Conversation Turns**: 9 +**Estimated Cost**: ~$3 (roughly 300k input tokens, mostly cached, on Opus) +**Model**: Opus 5.5 (claude-opus-5-5) + +## Key Actions + +- Audited every non-blog page in `docs/` for stale content and reported findings grouped by severity. +- Debugged Google Drive access: the small-business plugin's Drive server failed with a dynamic client registration error; after Mason removed the plugins and reloaded, the claude.ai Google Drive connector (mason@pytexas.org) became available. +- Walked through each stale page with AskUserQuestion to get per-page decisions. +- Pulled the 2026-04-19 annual meeting minutes from Drive and added them to `docs/foundation/minutes.md`; fixed the 2025 entry's date typo. +- Updated `docs/foundation/who.md` for the 2026 fiscal year and new term end dates. +- Updated `docs/sponsorship/meetup.md`: meetup list (Alamo Python rename, Houston PyLadies, PyLadies ATX), newsletter and Discord stats, Central Time, generic availability line. +- Removed `docs/foundation/sponsors.md` and `docs/foundation/fundraising.md`, dropped them from nav, and added redirects to `sponsorship/index.md`. +- Extended `docs/foundation/about.md` history; fixed the archive URL in `docs/conference.md`. +- Verified with `uv run mkdocs build --strict` (no warnings) and checked the generated redirect HTML. + +## Prompt Inventory + +| Prompt/Command | Action Taken | Outcome | +|---|---|---| +| Scan all pages and find out-of-date ones | Read every non-blog page, checked git dates | Audit report with clearly stale, probably stale, and fine buckets | +| What Google Drive are you linked to? | Called Drive plugin tool | Auth error; plugin Drive server not connected | +| I reauthed on claude.ai | Searched for claude.ai Drive tools, retried | Connector not loaded in session yet | +| Deleted plugins, try now | Called claude.ai Drive list_recent_files | Connected as mason@pytexas.org | +| Present each page, ask what to update | Three rounds of AskUserQuestion, Drive search for minutes and meetup data | Per-page decisions collected, edits applied | +| Commit and open the PR | Session summary, commit message, signed commit, PR | This summary | + +## Efficiency Insights + +**What went well:** +- The site is small, so reading every page directly in two Bash calls was faster than delegating to an agent. +- Pulling the 2026 minutes from Drive filled the minutes and officer gaps without asking Mason to retype them. + +**What could improve:** +- One multi-select question mixed "edit" options with a "redirect instead" option, which let Mason pick contradictory answers and cost an extra round. +- Tried to verify meetup.com URLs by HTTP status before realizing meetup.com returns 200 for nonexistent groups. + +**Course corrections:** +- Switched from the failing plugin Drive server to the claude.ai Drive connector. +- Kept Katy Python Coders after Mason confirmed it is still in the Meetup Pro network (inactive groups don't show in the scraped page). + +## Process Improvements + +- Keep mutually exclusive choices (redirect vs. edit) in a single-select question, not mixed into a multi-select list. +- Treat the Meetup Pro network page scrape as incomplete; it omits groups that haven't met recently. + +## Observations + +- mkdocs-redirects works without stub files in `docs/`; the existing "dead file" stubs (discord.md, links.md, etc.) are not required. +- The 2026 minutes doc in Drive was built from the 2025 template, so some financial lines carry over older values alongside new ones. + +## Suggested Skills for Next Session + +- `content-design:review-content`: any further prose updates to Foundation pages should get a style pass. diff --git a/docs/conference.md b/docs/conference.md index a868c97..a49b798 100644 --- a/docs/conference.md +++ b/docs/conference.md @@ -1,7 +1,7 @@ --- summary: Learn more about the PyTexas Conference. date: 2024-05-12 -modified: 2025-05-12 +modified: 2026-09-29 --- # The PyTexas Conference @@ -17,7 +17,7 @@ prior to [PyCon North America](https://us.pycon.org) ## Past Conferences -To view any previous conference year, use `https://pytexas/YEAR` as the URL. You can +To view any previous conference year, use `https://pytexas.org/YEAR` as the URL. You can go all the way back to 2007! ## History diff --git a/docs/foundation/about.md b/docs/foundation/about.md index bb6526e..9ade441 100644 --- a/docs/foundation/about.md +++ b/docs/foundation/about.md @@ -1,6 +1,6 @@ --- date: 2022-09-07 -modified: 2022-09-07 +modified: 2026-09-29 title: About Us summary: Who we are --- @@ -17,4 +17,12 @@ Founded in 2014, meetup organizers from Houston, Austin, and San Antonio came together to establish a non-profit organization whose mission would be to serve the Python community in Texas. Glen Zangirolami, Jeremy Boyd, and Kevin Horn were the Foundation's founders and first Board of Directors. In 2022, Mason -Egger was elected as president of the board, taking over for Glen. \ No newline at end of file +Egger was elected as president of the board, taking over for Glen. + +In the summer of 2023, the Foundation started the PyTexas Meetup, a monthly +virtual meetup for Pythonistas across Texas and beyond. At PyTexas 2024 we +launched the [Friends of PyTexas](../sponsorship/friends.md) program so +individuals could support the Foundation directly. The Foundation also supports +in-person Python meetups across the state through its +[Meetup Pro network](https://www.meetup.com/pro/pytexas/). In 2026, PyTexas +held its 20th conference. diff --git a/docs/foundation/fundraising.md b/docs/foundation/fundraising.md deleted file mode 100644 index f6f3280..0000000 --- a/docs/foundation/fundraising.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Sponsorship Information ---- - -# Sponsorship Information - -The PyTexas Foundation has two primary actions: - -- Run the PyTexas Conference, an annual gathering of Pythonistas that is 100% community organized and is funded through the generosity of our sponsors -- Run the semi-monthly PyTexas Meetup, a virtual meetup to share Python with the Texas technical community run by community volunteers - -We also host the PyTexas Discord, which provides both a space for Texas-based Pythonistas to build community and a space for the virtual meetup itself. - -## About the PyTexas Foundation -The PyTexas Foundation is a 501(c)3 non-profit organization dedicated to educating developers within Texas about Python. The PyTexas Conference is currently the foundation’s only fundraising event of the year. - -## How We Use The Funds -All sponsorship funds are used for the benefit of the PyTexas Foundation, Conference, Meetup, and the Texas Python community. We utilize funds to pay our venue, Discord, vendors, supplies, and all other things conference- and meetup-related. Any surplus funds that we collect are used to fund the minimal operating cost of the Foundation for the remainder of the year (primarily costs around bookkeeping, email, and foundation governance), as well as make next year’s PyTexas better. - -Also, in an attempt to make PyTexas as accessible as possible to everyone, we subsidize our Individual ticket prices with Corporate tickets and Sponsorship funds. By doing this we are able to keep PyTexas Individual tickets as low as possible, ensuring that everyone can attend. If an attendee can’t afford a ticket, they can apply for a grant where we can offer them free tickets and sometimes funds for travel expenses. - -## Health and Safety -Our attendees' health and safety, both phsyical and mental, are our top priority. -PyTexas is dedicated to creating a safe and inclusive space for all. -All sponsors are required to abide by our [Code of Conduct](code-of-conduct.md). - -If you’re interested in sponsoring PyTexas, please reach out to [sponsorship@pytexas.org](mailto:sponsorship@pytexas.org).We look forward to continue to serve the Python community in Texas for years to come, and we’d be honored if you were to help us achieve this goal. \ No newline at end of file diff --git a/docs/foundation/minutes.md b/docs/foundation/minutes.md index ce44de8..0debbd8 100644 --- a/docs/foundation/minutes.md +++ b/docs/foundation/minutes.md @@ -2,13 +2,77 @@ title: Meeting Minutes --- +## 2026-04-19 Annual Meeting + +#### Location +Austin Public Library, Austin, TX + +#### Date +2026-04-19 @ 3:00pm + +#### Attendees +Kevin Horn, Jeremy Boyd, Mason Egger, Laura Santamaria + +#### Agenda + +* Directorships +* Financial Review +* New Business + +#### Minutes + +1. Directorships + 1. President + 1. Jeremy nominates Mason, Kevin seconds, motion passes + 2. Vice President + 1. Jeremy nominates Kevin, Mason seconds, motion passes +2. Financial Report + 1. Conference Finances + 2. Revenue + 1. Sponsors: \~46k + 2. Attendees: north of 20k, to be finalized + 3. Total around 71k + 1. Still to be finalized: shirts, last-minute ticket sales + 3. Expenses + 1. Conference \~64k + 1. Still to be finalized: A/V, Sli.do, last-minute food, a couple of smaller items + 4. Takeaway: Likely 2-3k in the green + 5. Donations are up + 1. Some Friends of PyTexas signed up at the conference + 2. Donation default raised from $5 to $10 + 3. Lots of student tickets + 6. Finance app and tracking + 1. Laura and Jeremy to meet April 25-26 to discuss, if needed + 2. [Actual Budget](https://actualbudget.org) under consideration +3. New Business + 1. Taxes + 1. 2024 filed + 2. 2025 to be filed + 2. Meetup/Local Grant Program + 1. Black Python Devs didn't sponsor the Conference, sponsored the Foundation + 1. 20% of their sponsorship goes to PyHouston + 2. Dawn Wages donated her keynote honorarium to PyLadies + 1. $500, \~$250 already spent on food for the first meeting + 3. Smaller version of PSF grant system + 4. Can probably allocate $1-2k + 3. Proposal from Laura + 1. Opportunity to sub-lease storage, could be $500/yr or less + 4. Discussion of structural commitments vs. easily-ended ones + 1. Meetup is the only major structural cost we have + 2. Infrastructure needs to move to the new DigitalOcean account + 5. Banking + 1. Recent bank problems would have been avoidable with a credit card + 2. Look into a cash-back card +4. Adjournment + + ## 2025-04-13 Annual Meeting #### Location Austin Public Library, Austin, TX #### Date -2024-04-13 @ 3:00pm +2025-04-13 @ 3:00pm #### Attendees Kevin Horn, Jeremy Boyd, Mason Egger, Laura Santamaria diff --git a/docs/foundation/sponsors.md b/docs/foundation/sponsors.md deleted file mode 100644 index 1cb2400..0000000 --- a/docs/foundation/sponsors.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -title: Sponsors ---- - -Currently, sponsorship for the foundation coincides with sponsorship for the conference. More information on separate sponsorship is coming soon. \ No newline at end of file diff --git a/docs/foundation/who.md b/docs/foundation/who.md index a398f8d..9e87f9b 100644 --- a/docs/foundation/who.md +++ b/docs/foundation/who.md @@ -5,27 +5,27 @@ title: Who We Are ## Officers -Here are the officers for the 2024 fiscal year. +Here are the officers for the 2026 fiscal year. ### President -Mason Egger is the current president. He was elected in 2022 and holds the position until March 2026. +Mason Egger is the current president. He was first elected in 2022, was re-elected in April 2026, and holds the position until April 2028. ### Vice President Kevin Horn is the current vice president. He is a founding member of the PyTexas -Foundation and holds the position until March 2026. +Foundation, was re-elected in April 2026, and holds the position until April 2028. ### Treasurer Jeremy Boyd is the current treasurer. He is a founding member of the PyTexas -Foundation and holds the position until March 2026. +Foundation and holds the position until April 2027. ### Secretary Jeremy Boyd is the current secretary. He is a founding member of the PyTexas -Foundation and holds the position until April 2025. +Foundation, was re-elected in April 2025, and holds the position until April 2027. ## Board -The directors of the PyTexas Foundation for the fiscal year are the officers currently listed. \ No newline at end of file +The directors of the PyTexas Foundation for the fiscal year are the officers currently listed. diff --git a/docs/sponsorship/meetup.md b/docs/sponsorship/meetup.md index e5fcebb..9294c6e 100644 --- a/docs/sponsorship/meetup.md +++ b/docs/sponsorship/meetup.md @@ -11,8 +11,10 @@ We currently support: - [PyTexas Virtual Meetup](https://pytexas.org/meetup) - [Katy Python Coders](https://www.meetup.com/katy-python-coders/) - [PyHou - Python Houston Enthusiasts](https://www.meetup.com/python-14/) +- [Houston PyLadies](https://www.meetup.com/houston_pyladies/) +- [PyLadies ATX](https://www.meetup.com/pyladies-atx/) - [DFW Pythoneers](https://www.meetup.com/dfwpython/) -- [Alamo Python Learners](https://www.meetup.com/alamo-code-learners/) +- [Alamo Python](https://www.meetup.com/alamo-python/) with more coming soon! View them in our [Meetup Pro Network](https://www.meetup.com/pro/pytexas/)! @@ -31,12 +33,12 @@ _All benefits listed below are available with sponsorship. Benefits are active f - Email Newsletter - A mention in our monthly PyTexas Community Newsletter - 1 mention per quarter of sponsorship - - Newsletter consists of ~1,000 members - - Open rate ranges from 40%-50% + - Newsletter consists of ~1,200 members + - Open rate of ~30% - Meetup - Mention and thank you at every PyTexas Virtual Meetup - Current attendance ranges from 30 - 65 attendees - - Meets on the first Tuesday of the month at 8:00pm CST + - Meets on the first Tuesday of the month at 8:00pm Central Time - Speaking Opportunity - Ability to present to the PyTexas Virtual Meetup - 25 minute talk time limit @@ -46,7 +48,7 @@ _All benefits listed below are available with sponsorship. Benefits are active f - PyTexas approval required - [PyTexas Community Discord Server](https://discord.gg/jNPAbcNukj) - A thank you and mention once per quarter - - ~**800** members + - ~**1,600** members - [PyTexas Conference](https://pytexas.org/conference) Sponsorship Discounts - 5% discount on any tier per quarter sponsored @@ -57,4 +59,4 @@ _All benefits listed below are available with sponsorship. Benefits are active f ## Available Slots -We currently have 5 sponsorship slots available for Q2, 2024. +Email [sponsorship@pytexas.org](mailto:sponsorship@pytexas.org) for current availability. diff --git a/mkdocs.yml b/mkdocs.yml index 89a6e17..7a1dc2a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -38,8 +38,6 @@ nav: - 'Who we are': foundation/who.md - Governance: foundation/governance.md - 'Meeting minutes': foundation/minutes.md - - Fundraising: foundation/fundraising.md - - Sponsors: foundation/sponsors.md - Privacy: privacy.md - 'Code of Conduct': foundation/code-of-conduct.md - 'Contact Us': foundation/contact-us.md @@ -77,6 +75,8 @@ plugins: redirect_maps: 'discord.md': 'https://discord.gg/jNPAbcNukj' 'friends.md': 'sponsorship/friends.md' + 'foundation/sponsors.md': 'sponsorship/index.md' + 'foundation/fundraising.md': 'sponsorship/index.md' 'links.md': 'https://linktr.ee/pytexas' 'newsletter.md': 'https://mailchi.mp/035388afb48a/pytexas-community' '2019.md': 'https://2019.pytexas.org'