[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 don’t feel connected and you’re standing alone, the challenge looks much bigger."
Marc Fonteijn Ru ButlerIncrease your confidence, influence, and impact (through a Professional Community)
December 3, 2024
"Climate tech means always learning more; the world is learning so much every year."
Dem Gerolemou Alexis Oh Neef RehmanClimate technology fundamentals
May 15, 2024
"Mobile users gave Amazon a higher Net Promoter Score than desktop users, indicating a better mobile experience."
Daniela Magaña Flores Ariane Rahn Jeff Ephraim BanderAhead of Competition: Learn What UX Benchmarking Can Do for Your Business Today
March 10, 2022
"Design systems are not just components but guidelines, rules, and principles to create consistent experiences."
Abbey Smalley Sylas SouzaScaling UX Past the Size of Your Team
January 8, 2024
"We created a tiers of support model so even low priority projects get some level of guidance, even if just a 45-minute consultation."
Patrick CommarfordDesign Staffing for Impact
January 8, 2024
"We fundraised to cover Tatiana’s salary for three months so she could launch this project very quickly after the war started."
Xenia Adjoubei Sean BruceEmpowering Communities Through the Researcher in Residence Program
March 29, 2023
"The only form of ethical persuasion that exists is when the goals of the persuader are aligned with the goals of the persuading."
Craig VillamorDesign Systems for Ethical Design
January 26, 2023
"This isn’t more work—it's consolidating work that’s already happening scattered across tools into one connected place."
Jon Fukuda Ellie KryslDesign Planning and Management Support
October 3, 2023
"Designers tend to work behind closed doors because the design process is messy and chaotic, and they don’t want people to see that."
Iain McMaster IHan ChengDesign and Product: from Frenemy to Harmony
November 29, 2023
