[Demo] AI-powered UX enhancement: Aligning GitHub documentation with USWDS at Austin Public Library
Summary
In this session, I will explore the groundbreaking approach taken by the Austin Public Library's Innovation Lab in integrating AI with GitHub for UX enhancement. Our primary challenge was to streamline and enrich the documentation process, adhering to the complex guidelines of the U.S. Web Design System (USWDS) while ensuring the content was accessible and user-friendly. Leveraging AI, we developed a system that not only automates the creation of diverse documentation formats like Markdown, but also ensures alignment with USWDS standards. This innovative method significantly improved the efficiency of our documentation process, making it more coherent and navigable. A key highlight is our recent revamp of the Breadcrumbs navigation strategy, demonstrating AI's role in enhancing user experience and interface design. The session showcases how AI can transform UX practices, offering practical insights for UX professionals looking to leverage AI in their work. Takeaways 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
"People on the project were reporting back to management in their silo, not talking to one another."
Carl TurnerYou Can Do This: Understand and Solve Organizational Problems to Jumpstart a Dead Project
March 28, 2023
"With selfie pay, you take a picture, blink to prove it’s you alive, and authenticate in-app seamlessly and securely."
Karen PascoeDeveloping Experience Teams and Talent in the Enterprise
June 8, 2016
"Emojis and GIFs have become effective tools for remote teams to add expression and prevent miscommunication."
Jilanna WilsonDistributed Design Operations Management
October 23, 2019
"We have over 30 contracting teams spread across roughly 10 vendors all working on parts of the veteran experience landscape."
Shawna Hein Kevin HoffmanCreate a Cohesive Civic Design Practice Across Agency, Vendors, and Contracts
November 17, 2022
"The scoping of Canada’s COVID app protected people with new phones, but left vulnerable populations unserved."
Barb SpantonDoing Work That Matters: A Look Beyond The Idealistic Notion of 'Doing Meaningful Work'
June 10, 2022
"Dana is a reliable, solutions-oriented designer who prefers honest feedback but needs clear expectations."
Briana ThomasThe Quiet Force: Uncovering Hidden Leadership in High-Impact Design Teams
September 24, 2024
"Grandmas provide grounding, resilience, and long-term perspective often through rituals and storytelling."
Gina MendoliaTherapists, Coaches, and Grandmas: Techniques for Service Design in Complex Systems
December 3, 2024
"Now everyone’s an edge case, so research needs to focus on those edge cases, not just the average user."
Lija Hogan Milan Mijatovic Sam Proulx Louis RosenfeldThree Years Out: Perspectives on the Near-Term Future of User Research
March 15, 2024
"Our design ops team was a step behind the growth of our design team, solving the wrong problems at the wrong scale."
John Calhoun Rachel PosmanTwo Sides of the DesignOps Coin: Teams Ops and Product Ops
January 8, 2024
Latest Books All books
Dig deeper with the Rosenbot
How can storytelling be used to extract deeper insights without being extractive in user research?
Why are some organizations moving away from third-party customer data platforms (CDPs)?
How do organizations integrate customer feedback, survey data, and interview transcripts into a single research repository?