[Demo] AI-powered UX enhancement: Aligning GitHub documentation with USWDS at Austin Public Library
Summary
- Insight into the innovative use of AI for streamlining documentation processes, adhering to USWDS guidelines in a public library setting
- Practical examples of how AI can transform UX practices, with a focus on creating efficient, user-friendly, and standards-compliant documentation
- Demonstration of the AI-assisted update of the Breadcrumbs navigation strategy, demonstrating tangible improvements in UX design and user navigation
- Strategies for leveraging AI to enhance collaboration among UX designers, developers, and content creators, fostering a more integrated and effective workflow
- Tips for utilizing tools like GitHub Pages for rapid deployment and continuous integration, highlighting the role of AI in accelerating project development
Key Insights
-
•
Long-term stewardship of data requires not just preservation but contextualization and knowledge transfer.
-
•
AI, particularly ChatGPT, can effectively assist non-expert coders in writing, debugging, and documenting Python scripts.
-
•
Using markdown for documentation makes technical details accessible and readable in web browsers, aiding future users.
-
•
Ethical data stewardship involves openness, transparency, reuse, and modularity aligned with the US Web Design System principles.
-
•
Historical terminology in data (e.g., 'lunatic asylum') needs sensitive updating to reflect modern language while preserving discovery.
-
•
GitHub serves as a collaborative and version-controlled platform that can host data, scripts, and documentation for lasting accessibility.
-
•
Combining scrapers written in Python with AI enables efficient extraction and structuring of public data from websites into CSV.
-
•
Incremental iteration on scripts and documentation over time supports maintainability and adaptability.
-
•
Creating custom GPTs with preset instructions facilitates consistent documentation and adherence to standards.
-
•
Mentorship, community groups, and AI tools together help lower barriers for people new to coding and data projects.
Notable Quotes
"We don’t just want to hand over the data as a black box; we want to provide contextual information to preserve knowledge."
"I’m not a Python developer, I’m getting a lot of assistance from ChatGPT to help me write that."
"Markdown is very concise and useful, and GitHub can render it into human-readable, nicely formatted pages."
"We’re trying to do this ethically, calling upon the US Web Design System principles: be open, transparent, reuse and improve."
"If people are looking for lunatic asylum or Austin State Hospital, they should both be findable, but presented appropriately."
"You can copy and paste error messages into ChatGPT, and it can help you fix your scripts quickly."
"Public data has a life of its own; it is sometimes one thing, sometimes another, depending on context and display."
"This project is about creating community and enabling discovery, and that’s what makes us successful ethical data stewards."
"OpenAI’s custom GPTs allow adding files and instructions, making AI a real partner in documentation and governance."
"Find a mentor—an AI, a person, or a project—and use community resources like Open Austin to learn and grow."
Or choose a question:
More Videos
"If you value innovation and design, then you're investing in creativity."
Dr. Karl JeffriesThe Science of Creativity for DesignOps
January 8, 2024
"Show them, don’t tell them — involving stakeholders early builds skin in the game and helps control quality."
Amy MarquezINVEST: Discussion
June 15, 2018
"Trust is built by showing you’re there to help make them succeed, not just push your agenda."
Steve Portigal Chris Chapo Kelly Goto Christian RohrerDiscussion
May 13, 2015
"One designer's security in a dedicated model may be another designer's stagnation."
Alicia MootyDesign Staffing Models
September 30, 2021
"I believe there's really no such thing as a boring place at the state of mind."
Ana Maria Montero Barrantes Aditi Dhar Michelle Kaplan Nate Osborne Matt LaurenceThe Authentic UX Talent Show
January 8, 2024
"Simply asking stakeholders what success looks like for them in a project is a powerful way to start meaningful conversations."
Lada Gorlenko Sharbani Dhar Sébastien Malo Rob Mitzel Ivana Ng Michal Anne RogondinoTheme 1: Discussion
January 8, 2024
"Choosing a research repository is a big battle in your organization; the right decisions can really help you succeed."
Sofia QuinteroThe Product Philosophy Behind EnjoyHQ
March 10, 2021
"Please don’t chop off that engine until the new one is built because you are not the only one on this plane."
Laura KleinUnique challenges of innovation in enterprises
April 23, 2020
"My playlist changed drastically when my son was born, but data alone wouldn’t explain why."
Andrew MichaelBuilding a Product Insights Team
March 10, 2022
Latest Books All books
Dig deeper with the Rosenbot
Why is it expensive and complicated to design AI-powered UX across different platforms like Slack, Teams, and Claude?
Why do s****y maps work better than polished prototypes to resolve confusion with clients?
How important is fluency across business, customer, technology, design, and data domains for product managers?