Improving WordPress Themes & PluginsSupport Documentation By Gloria Antonelli
About.meFine artistStarted web dev in mid 90’sCrazy about learning new technologyLearn from the bestLove to teach what I learnGo to a lot of conferencesShy online but not in personI consult, train and sometimes write. http://2011.chicago.wordcamp.org/2011/07/23/interview-with-gloria-antonelli/
Support documents & learning channelsarekey for greatUser Experience.
The ProblemToo many frustrated users are searching for answers on how to use your products.examples: All in one SEO & Thematic
It’s been the Wild West in WP development land.Are we ready to settle down with some standards in support document creation?
WP Gold Standardthreed’sthedevelopmentdesigndocumentationCreate standards without stifling innovation and creativity.
Questions to ask yourself.What is your business model?Business goals?Full-time venture?Who are your target users?What is your development philosophy?Why are you making themes & plugins?Once you know tell your users!
the team : many hats, jobs & skillsCODE   DESIGN   UI   UX   IA  SEOThe holy trinityUX IA Dev
Are you wearing all the hats?
For users to easily find information to configure, modify & use your products.EXPECTATIONS
The Long Tail of UsersHeadexperienced usersLong Tailnew & non tech usersUnlimited niche users with various skill sets
The Learning CurveDifficultHeadexperienced usersEasyLong Tailnew & non tech usersUnlimited niche users with various skill sets
The Learning CurveDifficultHeadexperienced usersEasyLong Tailnew & non tech userslimitedUnlimited niche users with various skill sets
The Learning CurveDifficultAre you addressing the needs of this market segment?Easy[new & non tech users]
Target Users Skill Set****an estimate of skill sets *refers to all JavaScript libraries
“please care about your end users”Gary VaynerchukFOWA Vegas 2011
WP Learning CurvehtmlMultiple learning layersWordPress UI Theme Functionality Theme Options Theme Widgets Many Pluginscssphp
WP Learning CurveAdvanced learning layershtmlWordPress UI Theme Functionality Theme Options Theme Widgets Many Pluginscssphp
Users ProcessDecide to use WordPressPlugin SelectionSet upThemeModifyThemeTheme Selection>>>>repeat as neededread docssearch webview videosview tutorialssearch webread reviewsselect & hopefor the best read docssearch webview videosview tutorialssearch webread reviewsread docssearch web
Theme Support,Option Page UI,& Pluginseveryone is differentDon’t know what to expect until you buy in.are youmaking users crazy?
Move from Dev Centric to User CentricIs there a clear learning path          for all users?
Create a [UX-Centric] ProcessThink of users needs throughout each step.Create a [UX-Centric] Process Think of users needs throughout each step.
Brainstorm ideas/solutions to ease pain points.Create a [UX-Centric] Process Think of users needs throughout each step.
 Brainstorm ideas/solutions to ease pain points.
Collect data from users in each target segment.Create a [UX-Centric] Process Think of users needs throughout each step.
 Brainstorm ideas/solutions to ease pain points.
 Collect data from users in each target segment.
Develop a prototype of learning channels.Create a [UX-Centric] Process Think of users needs throughout each step.
 Brainstorm ideas/solutions to ease pain points.
 Collect data from users in each target segment.
 Develop a prototype of learning channels.
Create a foundation for the learning center.Create a [UX-Centric] Process Think of users needs throughout each step.
 Brainstorm ideas/solutions to ease pain points.
 Collect data from users in each target segment.
 Develop a prototype of learning channels.
 Create a foundation for the learning center.
Write content, create videos, and tutorials.Create a [UX-Centric] Process Think of users needs throughout each step.
 Brainstorm ideas/solutions to ease pain points.
 Collect data from users in each target segment.
 Develop a prototype of learning channels.
 Create a foundation for the learning center.
 Write content, create videos, and tutorials.
Conduct usability testing as you go along.“Don’t Make Me Think”By Steve KrugA Common Sense Approach to Web UsabilityThe Do-It-Yourself Guide to Finding and Fixing Usability Problemshttp://www.sensible.com/
User Pain PointsDon’t know where to start.
 Understanding features in different themes.
 Unfamiliar with terms & finding info.
 Different naming conventions.
 Next iterations of WP core.
 No theme support evaluation system.Don’t start with just a forum!
Don’t start with just a forum!Users need more step by step:
Don’t start with just a forum!Users need more step by step:“get started” instructions – install  & configure
Don’t start with just a forum!Users need more step by step:“get started” instructions – install  & configure  guides for troubleshooting, option page, features,       modifying the themeForums have a place but best to give answers before they areasked.
Don’t start with just a forum!Users need more step by step:“get started” instructions – install  & configure  guides for troubleshooting, option page, features,       modifying the theme    advance code & developers guide
Don’t start with just a forum!Users need more step by step:“get started” instructions – install  & configure  guides for troubleshooting, option page, features,       modifying the theme    advance code & developers guide     videos, tutorials and faq
Don’t start with just a forum!Users need more step by step:“get started” instructions – install  & configure  guides for troubleshooting, option page, features,       modifying the theme    advance code & developers guide     videos, tutorials and faq       links to external  resources
Don’t start with just a forum!Users need more step by step:get started instructions – install  & configure  guides for troubleshooting, option page, features,       modifying the theme    advance code & developers guide     videos, tutorials and faq       links to external  resourcesForums have a place but best to give answers before they areasked.
Create Multiple ChannelsGuidesForumVideosTutorials
Documentation TipsInformation ArchitectureFindabilityVisual PresentationInstructional CreationConcept Map ModelBest Practices
Information Architectureis the categorization of information into a coherent structure.
Information ArchitectureArrange in order of importance
Information ArchitectureArrange in order of importance Arrange in order of skill level
Information ArchitectureArrange in order of importance Arrange in order of skill levelClear calls of action (Start Here)
Information ArchitectureArrange in order of importance Arrange in order of skill levelClear calls of action (Start Here)Clear navigation
Information ArchitectureArrange in order of importance Arrange in order of skill levelClear calls of action (Start Here)Clear navigationUse descriptive headlines
Information ArchitectureArrange in order of importance Arrange in order of skill levelClear calls of action (Start Here)Clear navigationUse descriptive headlinesUI consistency for ease of use

Improving WordPress Themes & Plugins Support Documentation