Skip to content

Instantly share code, notes, and snippets.

@audreyfeldroy
Created September 27, 2025 06:30
Show Gist options
  • Save audreyfeldroy/9ff89a3c23be90b56334622b781cc61e to your computer and use it in GitHub Desktop.
Save audreyfeldroy/9ff89a3c23be90b56334622b781cc61e to your computer and use it in GitHub Desktop.
First draft of the README.md for the forthcoming Voices of PyLadies Manila repo, to present at the inaugural coding sprint that I'm leading today. https://www.meetup.com/pyladiesmanila/events/311117699/

Voices of PyLadies Manila

A web app showcasing the journeys of PyLadies Manila members, from their early days learning programming to their growth as experienced Python developers. This platform features audio clips of inspiring stories from Manila women Python devs of all ages and backgrounds, highlighting their experiences, challenges, and achievements in the Python community.

About the Project

Voices of PyLadies Manila is dedicated to documenting women's experiences getting into programming and Python development in Manila. The website serves as a collection of everyone's personal stories and experiences, sharing the unique journeys of women from the time they learned programming, how they built their Python development skills, and what they are currently doing with Python today. Each audio clip represents a personal narrative of growth, challenges, and success in the tech field.

This project also exists to give us something fresh to collaborate on together, helping each other build our open-source contribution portfolio and skills.

Features

  • Audio Story Collection: A curated collection of audio clips featuring PyLadies Manila members sharing their programming journeys
  • Member Profiles: Detailed profiles of contributors with their background and Python journey milestones
  • Responsive Design: Built to look great on all devices, from desktop computers to mobile phones
  • Easy Navigation: Intuitive interface for browsing and searching stories by topic, experience level, or member
  • Modern Filipino Tech Stack: Built with AIR, the modern full-stack Python web framework proudly being created in the Philippines
  • Community Focused: Platform designed to encourage and inspire other women to join the Python community
  • Accessibility: Designed with accessibility in mind to ensure everyone can access the stories

Technology Stack

  • Web Framework: AIR
  • Frontend: Jinja2 templating, modern CSS, and HTMX
  • Audio: Optimized audio playback for best listening experience
  • Database: None to start, later PostgreSQL
  • Deployment: Details to be determined

Contributing

We welcome contributions from the community! Whether you're a developer, designer, programming newbie, or friend of the PyLadies community, there are many ways to get involved. Start by attending a PyLadies Manila meetup and talking to us, or reaching out to us via Discord.

Acknowledgments

  • Thank you to the PyLadies Manila community for sharing stories and building this project together
  • Inspired by several needs: to give us a project to build and grow together, to help showcase hardworking volunteers' efforts, to amplify each others' voices, and more
  • Special thanks to Python Philippines advisors/mentors Audrey M. Roy Greenfeld and Daniel Roy Greenfeld for volunteering to build out AIR features, provide AIR bug fixes to support this project, lead coding sprints, and more
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment