SlideShare uma empresa Scribd logo
1 de 67
documenting design
a critical step in any developers work flow



                                9/19/2012 - LISA SABIN-WILSON
Lisa Sabin-Wilson
•DESIGNER SINCE 1998
•“DEVELOPER” SINCE 2003
•DEVELOPER SINCE 2007
•AUTHOR: WORDPRESS FOR DUMMIES
•OWNER: EWEBSCAPES DESIGN STUDIO




                                   9/19/2012 - LISA SABIN-WILSON
documenting design ...



                   9/19/2012 - LISA SABIN-WILSON
lives within that precious
space between
design &
development
                    9/19/2012 - LISA SABIN-WILSON
Let’s call it
assumption alley - -
because this is where
MOST of the assumptions
begin and then stick.

                  9/19/2012 - LISA SABIN-WILSON
Eliminate
Assumptions
• Saves time
• Reduces headaches
• Avoids hard feelings
• Happy client
• Happy developer




                         9/19/2012 - LISA SABIN-WILSON
Set
Expectations
Early
• Keeps project realistic
• Keeps projects on time
• Avoids miscommunication
• Happy client
• Happy developer



                            9/19/2012 - LISA SABIN-WILSON
Document
Project
Requirements
• Ready reference point for all
• Eliminates “he said/she said”
• Provides a work flow
• Happy client
• Happy developer



                                  9/19/2012 - LISA SABIN-WILSON
NOT YOUR AVERAGE JOES
PROJECT




          HTTP://NYAJ.COM
DATE                    CLIENT
          JULY 2012              NOT YOUR AVERAGE JOES
NOT YOUR AVERAGE JOE’S
PROJECT




          HTTP://NYAJ.COM
DATE                    CLIENT
          JULY 2012              NOT YOUR AVERAGE JOE’S
INITIAL CLIENT CONTACT
                       |
           PRE-SALES DISCUSSIONS
                       |
            INITIAL REQUIREMENTS
                       |
Typical      STATEMENT OF WORK
                       |
work flow       DESIGN PROCESS
                       |
               DESIGN APPROVAL
                       |
                 DEVELOPMENT
                       |
                    TESTING
                       |
                    GO LIVE!
                         9/19/2012 - LISA SABIN-WILSON
INITIAL CLIENT CONTACT
                          |
              PRE-SALES DISCUSSIONS
                          |
               INITIAL REQUIREMENTS
                          |

New-Typical
                STATEMENT OF WORK
                          |
                  DESIGN PROCESS

work flow                  |
              DESIGN DOCUMENTATION
                          |
                  DESIGN APPROVAL
                          |
                    DEVELOPMENT
                          |
                       TESTING
                          |
                       GO LIVE!
documenting the design
files eliminates the guess
work.


                   9/19/2012 - LISA SABIN-WILSON
WE BUILT A SITEMAP - WHICH WAS HELPFUL...
BUT IT WASN’T ENOUGH                9/19/2012 - LISA SABIN-WILSON
WE HAD A 16 PAGE STATEMENT OF WORK
BUT IT STILL WASN’T ENOUGH           9/19/2012 - LISA SABIN-WILSON
PSD Files Acquired.
    DESIGN APPROVAL DONE!

                            9/19/2012 - LISA SABIN-WILSON
A TOTAL OF 26 DIFFERENT PAGE VIEWS/LAYOUTS
BELIEVE IT OR NOT ... THIS WAS STILL NOT ENOUGH   9/19/2012 - LISA SABIN-WILSON
at this point?
it is really tempting to dig
right in and start
developing this bad boy.

                     9/19/2012 - LISA SABIN-WILSON
the sooner you get it done...

the sooner you get paid.
the sooner you can update your portfolio.
the sooner the client is happy.



                                9/19/2012 - LISA SABIN-WILSON
right?



         9/19/2012 - LISA SABIN-WILSON
What they wanted... ?

       LISA NEEDS TO START DEVELOPMENT NOW
                      BECAUSE
    WE WANT THIS DONE & LIVE IN LESS THAN 30 DAYS.




                                         9/19/2012 - LISA SABIN-WILSON
What they needed... ?
                STOP ... TAKE A BREATH ...

         LISA NEEDS TO DEFINE THE DEVELOPMENT
    IN A WAY THAT TAKES QUESTIONS OUT OF THE ENTIRE
                 DEVELOPMENT PROCESS.




                                             9/19/2012 - LISA SABIN-WILSON
eliminate
  remove
obliterate assumptions.
as a developer - I can
make assumptions with
the BEST of them
assumptions are based on
a persons own frame of
reference.
what i see in my head will
be different from what you
see in your head.
interpretations will vary.
For example . . .
THE LANDING PAGE
THERE IS A LOT GOING ON HERE
i made some assumptions
           :(


                 9/19/2012 - LISA SABIN-WILSON
THE LANDING PAGE
MORE PHOTOS? IT’S A SIDEBAR CAROUSEL - IT FLIPS THROUGH STAFF PHOTOS
THE LANDING PAGE
THE REALITY .... THE CLIENT’S INTENTION ? ...
THE LANDING PAGE
THE REALITY .... IT’S A SLIDESHOW/CAROUSEL OF PHOTOS IN THE MAIN BODY
a sidebar carousel
is HUGELY different
than a slideshow in the
main content area.

                    9/19/2012 - LISA SABIN-WILSON
if i had gone with my
initial assumption without
discovering the clients
intention ...

                    9/19/2012 - LISA SABIN-WILSON
i would have wasted time.



                   9/19/2012 - LISA SABIN-WILSON
i would have presented
incorrect work to the
client.


                  9/19/2012 - LISA SABIN-WILSON
i would risk the client
losing confidence in me.


                  9/19/2012 - LISA SABIN-WILSON
especially if i had made
my next assumption . . .


                    9/19/2012 - LISA SABIN-WILSON
THE LANDING PAGE
REMEMBER THIS?     9/19/2012 - LISA SABIN-WILSON
THE LANDING PAGE
JOIN OUR EMAIL CLUB - - LINKS TO A PAGE WITH A SUBSCRIPTION FORM - RIGHT?
THE LANDING PAGE
NOT EXACTLY - CLICK IT AND IT OPENS INLINE - NO NEW PAGE LOAD.   9/19/2012 - LISA SABIN-WILSON
THE NAVIGATION MENU
LINKS TO INTERNAL PAGES?   9/19/2012 - LISA SABIN-WILSON
THE LANDING PAGE
NOPE! IT CONTAINS A FLY OUT MENU WITH SUB NAVIGATION   9/19/2012 - LISA SABIN-WILSON
none of this was indicated

        •INITIAL REQUIREMENTS
        •STATEMENT OF WORK
        •SITE MAP
        •PSD FILES




                                9/19/2012 - LISA SABIN-WILSON
a smart developer

       •RECOGNIZES GAPS
       •ASKS QUESTIONS
       •SEEKS ANSWERS
       •REQUIRES CLARIFICATION




                                 9/19/2012 - LISA SABIN-WILSON
i have not always been a
smart developer
      •WASTED HOURS UPON HOURS
      •FRUSTRATING BACK AND FORTH
      •LOST MONEY
      •FRUSTRATED CLIENTS
      •SCOPE CREEP
      •NEVER ENDING PROJECT


                                9/19/2012 - LISA SABIN-WILSON
when you have your hands
on the approved design
files - get into the mind of
the user


                    9/19/2012 - LISA SABIN-WILSON
you know ....

the person who is actually
going to use the web site


                   9/19/2012 - LISA SABIN-WILSON
you will do yourself and
your client a favor if you
start asking questions
like...


                     9/19/2012 - LISA SABIN-WILSON
what
happens
when I click
this?

               9/19/2012 - LISA SABIN-WILSON
how many photos
are loaded into this
carousel?

what happens when i
click “more photos?”

does clicking on an
individual photo take
me anywhere?
                        9/19/2012 - LISA SABIN-WILSON
asking questions like
these gives the client
the chance to correct
your assumptions...


“oh no, that’s not for those photos ...
it’s for the main photos on the left!”




                                          9/19/2012 - LISA SABIN-WILSON
so then you can
clarify....

•HOW MANY PHOTOS?
•ARE THEY LINKED TO ANYTHING?
•ARE THESE POSTS WITH
 FEATURED IMAGES?
•DOES THIS HAPPEN ON OTHER
 PAGES?
•OR JUST THE HOME PAGE?

                                9/19/2012 - LISA SABIN-WILSON
wherever
there is an
action
indicated ...
clarify it
                9/19/2012 - LISA SABIN-WILSON
Never be
afraid to...
ask questions
get clarification
correct your assumptions
Doing so
shows ...
initiative
motivation to do it right
confidence
thoroughness
but wait ....

don’t stop at simply having
the conversation


                   9/19/2012 - LISA SABIN-WILSON
document it.




               9/19/2012 - LISA SABIN-WILSON
make it part of the
contract.



                      9/19/2012 - LISA SABIN-WILSON
before you lay down one
single piece of code - get
your client to sign off on it.


                      9/19/2012 - LISA SABIN-WILSON
find a
method you
prefer - but
definitely
document it
               9/19/2012 - LISA SABIN-WILSON
•AUDIO: RECORD THE CONVERSATION
•OLD SCHOOL: SPREADSHEET
•CONCEPT SHARE
•HTTP://WWW.CONCEPTSHARE.COM
•CAGE APP
•HTTP://WWW.CAGEAPP.COM




                                  9/19/2012 - LISA SABIN-WILSON
whatever method you
choose to use - make sure
you document the process


                  9/19/2012 - LISA SABIN-WILSON
Documenting each
element in the project
added approximately
2 hours.


                    9/19/2012 - LISA SABIN-WILSON
if it wasn’t documented
              ...
      it didn’t happen


                 9/19/2012 - LISA SABIN-WILSON
The End.



           9/19/2012 - LISA SABIN-WILSON

Mais conteúdo relacionado

Destaque

Design principles
Design principlesDesign principles
Design principlesklhall700
 
Document Design: Basic Principles
Document Design: Basic Principles Document Design: Basic Principles
Document Design: Basic Principles Alan Bowman
 
Design Documentation
Design DocumentationDesign Documentation
Design DocumentationPeter Boersma
 
M5 - Graphic Design - Text
M5 - Graphic Design - TextM5 - Graphic Design - Text
M5 - Graphic Design - TextJamie Hutt
 
Elements of Design - Graphic Design 1
Elements of Design - Graphic Design 1Elements of Design - Graphic Design 1
Elements of Design - Graphic Design 1Dawn Nicole Hamby
 
Design documentation
Design documentationDesign documentation
Design documentationnicky_walters
 
Good Examples of Bad Design
Good Examples of Bad DesignGood Examples of Bad Design
Good Examples of Bad DesignThe Mechanism
 
Principle of design
Principle of designPrinciple of design
Principle of designRahul Gupta
 
Miva + WordPress
Miva + WordPressMiva + WordPress
Miva + WordPressMiva
 
Tools for Mobile UX Design
Tools for Mobile UX DesignTools for Mobile UX Design
Tools for Mobile UX DesignSteven Hoober
 
Technical Communication; Definition and Classification
Technical Communication; Definition and ClassificationTechnical Communication; Definition and Classification
Technical Communication; Definition and ClassificationShan Loveres
 
User Centred Design (UCD) Presentation
User Centred Design (UCD) PresentationUser Centred Design (UCD) Presentation
User Centred Design (UCD) PresentationVinai Kumar
 
Ux Design for Mobile Apps
Ux Design for Mobile AppsUx Design for Mobile Apps
Ux Design for Mobile Appsinmediatum.com
 
UX Design for Mobile Interfaces
UX Design for Mobile InterfacesUX Design for Mobile Interfaces
UX Design for Mobile InterfacesAndi Galpern
 
2016 Mobile Design & UX Trends
2016 Mobile Design & UX Trends2016 Mobile Design & UX Trends
2016 Mobile Design & UX TrendsMiva
 
UX Design for Mobile Payment Experiences
UX Design for Mobile Payment ExperiencesUX Design for Mobile Payment Experiences
UX Design for Mobile Payment ExperiencesSkip Allums
 
Videogame Design and Programming - 08 The Design Document
Videogame Design and Programming - 08 The Design DocumentVideogame Design and Programming - 08 The Design Document
Videogame Design and Programming - 08 The Design DocumentPier Luca Lanzi
 

Destaque (20)

Module 5
Module 5Module 5
Module 5
 
Design principles
Design principlesDesign principles
Design principles
 
Document Design: Basic Principles
Document Design: Basic Principles Document Design: Basic Principles
Document Design: Basic Principles
 
7 Deadly Font Sins
7 Deadly Font Sins7 Deadly Font Sins
7 Deadly Font Sins
 
Design Documentation
Design DocumentationDesign Documentation
Design Documentation
 
Text design
Text designText design
Text design
 
M5 - Graphic Design - Text
M5 - Graphic Design - TextM5 - Graphic Design - Text
M5 - Graphic Design - Text
 
Elements of Design - Graphic Design 1
Elements of Design - Graphic Design 1Elements of Design - Graphic Design 1
Elements of Design - Graphic Design 1
 
Design documentation
Design documentationDesign documentation
Design documentation
 
Good Examples of Bad Design
Good Examples of Bad DesignGood Examples of Bad Design
Good Examples of Bad Design
 
Principle of design
Principle of designPrinciple of design
Principle of design
 
Miva + WordPress
Miva + WordPressMiva + WordPress
Miva + WordPress
 
Tools for Mobile UX Design
Tools for Mobile UX DesignTools for Mobile UX Design
Tools for Mobile UX Design
 
Technical Communication; Definition and Classification
Technical Communication; Definition and ClassificationTechnical Communication; Definition and Classification
Technical Communication; Definition and Classification
 
User Centred Design (UCD) Presentation
User Centred Design (UCD) PresentationUser Centred Design (UCD) Presentation
User Centred Design (UCD) Presentation
 
Ux Design for Mobile Apps
Ux Design for Mobile AppsUx Design for Mobile Apps
Ux Design for Mobile Apps
 
UX Design for Mobile Interfaces
UX Design for Mobile InterfacesUX Design for Mobile Interfaces
UX Design for Mobile Interfaces
 
2016 Mobile Design & UX Trends
2016 Mobile Design & UX Trends2016 Mobile Design & UX Trends
2016 Mobile Design & UX Trends
 
UX Design for Mobile Payment Experiences
UX Design for Mobile Payment ExperiencesUX Design for Mobile Payment Experiences
UX Design for Mobile Payment Experiences
 
Videogame Design and Programming - 08 The Design Document
Videogame Design and Programming - 08 The Design DocumentVideogame Design and Programming - 08 The Design Document
Videogame Design and Programming - 08 The Design Document
 

Mais de Lisa Sabin-Wilson

You Should Charge More - - Design/Development Services Pricing
You Should Charge More - - Design/Development Services PricingYou Should Charge More - - Design/Development Services Pricing
You Should Charge More - - Design/Development Services PricingLisa Sabin-Wilson
 
Internationalization: Preparing Your WordPress Theme for the Rest of the World
Internationalization: Preparing Your WordPress Theme for the Rest of the WorldInternationalization: Preparing Your WordPress Theme for the Rest of the World
Internationalization: Preparing Your WordPress Theme for the Rest of the WorldLisa Sabin-Wilson
 
Getting involved: Help Make WordPress
Getting involved: Help Make WordPressGetting involved: Help Make WordPress
Getting involved: Help Make WordPressLisa Sabin-Wilson
 
Scoping Projects to avoid stress, headaches and angry mobs
Scoping Projects to avoid stress, headaches and angry mobsScoping Projects to avoid stress, headaches and angry mobs
Scoping Projects to avoid stress, headaches and angry mobsLisa Sabin-Wilson
 
Oh The Themes That You'll Do! - WordCamp Philly 2012
Oh The Themes That You'll Do! - WordCamp Philly 2012Oh The Themes That You'll Do! - WordCamp Philly 2012
Oh The Themes That You'll Do! - WordCamp Philly 2012Lisa Sabin-Wilson
 
This is BuddyPress, Install it maybe
This is BuddyPress, Install it maybeThis is BuddyPress, Install it maybe
This is BuddyPress, Install it maybeLisa Sabin-Wilson
 
Exploring WordPress Multisite
Exploring WordPress MultisiteExploring WordPress Multisite
Exploring WordPress MultisiteLisa Sabin-Wilson
 
Self Publishing - Web Based Author Tools by Lisa Sabin-Wilson
Self Publishing - Web Based Author Tools by Lisa Sabin-WilsonSelf Publishing - Web Based Author Tools by Lisa Sabin-Wilson
Self Publishing - Web Based Author Tools by Lisa Sabin-WilsonLisa Sabin-Wilson
 
Tips for running a successful web studio
Tips for running a successful web studioTips for running a successful web studio
Tips for running a successful web studioLisa Sabin-Wilson
 
Creating Community with BuddyPress
Creating Community with BuddyPressCreating Community with BuddyPress
Creating Community with BuddyPressLisa Sabin-Wilson
 

Mais de Lisa Sabin-Wilson (11)

You Should Charge More - - Design/Development Services Pricing
You Should Charge More - - Design/Development Services PricingYou Should Charge More - - Design/Development Services Pricing
You Should Charge More - - Design/Development Services Pricing
 
Internationalization: Preparing Your WordPress Theme for the Rest of the World
Internationalization: Preparing Your WordPress Theme for the Rest of the WorldInternationalization: Preparing Your WordPress Theme for the Rest of the World
Internationalization: Preparing Your WordPress Theme for the Rest of the World
 
Getting involved: Help Make WordPress
Getting involved: Help Make WordPressGetting involved: Help Make WordPress
Getting involved: Help Make WordPress
 
Scoping Projects to avoid stress, headaches and angry mobs
Scoping Projects to avoid stress, headaches and angry mobsScoping Projects to avoid stress, headaches and angry mobs
Scoping Projects to avoid stress, headaches and angry mobs
 
Oh The Themes That You'll Do! - WordCamp Philly 2012
Oh The Themes That You'll Do! - WordCamp Philly 2012Oh The Themes That You'll Do! - WordCamp Philly 2012
Oh The Themes That You'll Do! - WordCamp Philly 2012
 
This is BuddyPress, Install it maybe
This is BuddyPress, Install it maybeThis is BuddyPress, Install it maybe
This is BuddyPress, Install it maybe
 
Exploring WordPress Multisite
Exploring WordPress MultisiteExploring WordPress Multisite
Exploring WordPress Multisite
 
WordPress is for EVERYONE
WordPress is for EVERYONEWordPress is for EVERYONE
WordPress is for EVERYONE
 
Self Publishing - Web Based Author Tools by Lisa Sabin-Wilson
Self Publishing - Web Based Author Tools by Lisa Sabin-WilsonSelf Publishing - Web Based Author Tools by Lisa Sabin-Wilson
Self Publishing - Web Based Author Tools by Lisa Sabin-Wilson
 
Tips for running a successful web studio
Tips for running a successful web studioTips for running a successful web studio
Tips for running a successful web studio
 
Creating Community with BuddyPress
Creating Community with BuddyPressCreating Community with BuddyPress
Creating Community with BuddyPress
 

Último

The Ultimate Guide to Choosing WordPress Pros and Cons
The Ultimate Guide to Choosing WordPress Pros and ConsThe Ultimate Guide to Choosing WordPress Pros and Cons
The Ultimate Guide to Choosing WordPress Pros and ConsPixlogix Infotech
 
"ML in Production",Oleksandr Bagan
"ML in Production",Oleksandr Bagan"ML in Production",Oleksandr Bagan
"ML in Production",Oleksandr BaganFwdays
 
DSPy a system for AI to Write Prompts and Do Fine Tuning
DSPy a system for AI to Write Prompts and Do Fine TuningDSPy a system for AI to Write Prompts and Do Fine Tuning
DSPy a system for AI to Write Prompts and Do Fine TuningLars Bell
 
What is DBT - The Ultimate Data Build Tool.pdf
What is DBT - The Ultimate Data Build Tool.pdfWhat is DBT - The Ultimate Data Build Tool.pdf
What is DBT - The Ultimate Data Build Tool.pdfMounikaPolabathina
 
Commit 2024 - Secret Management made easy
Commit 2024 - Secret Management made easyCommit 2024 - Secret Management made easy
Commit 2024 - Secret Management made easyAlfredo García Lavilla
 
New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024BookNet Canada
 
Tampa BSides - Chef's Tour of Microsoft Security Adoption Framework (SAF)
Tampa BSides - Chef's Tour of Microsoft Security Adoption Framework (SAF)Tampa BSides - Chef's Tour of Microsoft Security Adoption Framework (SAF)
Tampa BSides - Chef's Tour of Microsoft Security Adoption Framework (SAF)Mark Simos
 
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024BookNet Canada
 
Moving Beyond Passwords: FIDO Paris Seminar.pdf
Moving Beyond Passwords: FIDO Paris Seminar.pdfMoving Beyond Passwords: FIDO Paris Seminar.pdf
Moving Beyond Passwords: FIDO Paris Seminar.pdfLoriGlavin3
 
Scanning the Internet for External Cloud Exposures via SSL Certs
Scanning the Internet for External Cloud Exposures via SSL CertsScanning the Internet for External Cloud Exposures via SSL Certs
Scanning the Internet for External Cloud Exposures via SSL CertsRizwan Syed
 
Advanced Computer Architecture – An Introduction
Advanced Computer Architecture – An IntroductionAdvanced Computer Architecture – An Introduction
Advanced Computer Architecture – An IntroductionDilum Bandara
 
Use of FIDO in the Payments and Identity Landscape: FIDO Paris Seminar.pptx
Use of FIDO in the Payments and Identity Landscape: FIDO Paris Seminar.pptxUse of FIDO in the Payments and Identity Landscape: FIDO Paris Seminar.pptx
Use of FIDO in the Payments and Identity Landscape: FIDO Paris Seminar.pptxLoriGlavin3
 
SIP trunking in Janus @ Kamailio World 2024
SIP trunking in Janus @ Kamailio World 2024SIP trunking in Janus @ Kamailio World 2024
SIP trunking in Janus @ Kamailio World 2024Lorenzo Miniero
 
"Debugging python applications inside k8s environment", Andrii Soldatenko
"Debugging python applications inside k8s environment", Andrii Soldatenko"Debugging python applications inside k8s environment", Andrii Soldatenko
"Debugging python applications inside k8s environment", Andrii SoldatenkoFwdays
 
How to write a Business Continuity Plan
How to write a Business Continuity PlanHow to write a Business Continuity Plan
How to write a Business Continuity PlanDatabarracks
 
Generative AI for Technical Writer or Information Developers
Generative AI for Technical Writer or Information DevelopersGenerative AI for Technical Writer or Information Developers
Generative AI for Technical Writer or Information DevelopersRaghuram Pandurangan
 
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024BookNet Canada
 
Nell’iperspazio con Rocket: il Framework Web di Rust!
Nell’iperspazio con Rocket: il Framework Web di Rust!Nell’iperspazio con Rocket: il Framework Web di Rust!
Nell’iperspazio con Rocket: il Framework Web di Rust!Commit University
 
TrustArc Webinar - How to Build Consumer Trust Through Data Privacy
TrustArc Webinar - How to Build Consumer Trust Through Data PrivacyTrustArc Webinar - How to Build Consumer Trust Through Data Privacy
TrustArc Webinar - How to Build Consumer Trust Through Data PrivacyTrustArc
 
Dev Dives: Streamline document processing with UiPath Studio Web
Dev Dives: Streamline document processing with UiPath Studio WebDev Dives: Streamline document processing with UiPath Studio Web
Dev Dives: Streamline document processing with UiPath Studio WebUiPathCommunity
 

Último (20)

The Ultimate Guide to Choosing WordPress Pros and Cons
The Ultimate Guide to Choosing WordPress Pros and ConsThe Ultimate Guide to Choosing WordPress Pros and Cons
The Ultimate Guide to Choosing WordPress Pros and Cons
 
"ML in Production",Oleksandr Bagan
"ML in Production",Oleksandr Bagan"ML in Production",Oleksandr Bagan
"ML in Production",Oleksandr Bagan
 
DSPy a system for AI to Write Prompts and Do Fine Tuning
DSPy a system for AI to Write Prompts and Do Fine TuningDSPy a system for AI to Write Prompts and Do Fine Tuning
DSPy a system for AI to Write Prompts and Do Fine Tuning
 
What is DBT - The Ultimate Data Build Tool.pdf
What is DBT - The Ultimate Data Build Tool.pdfWhat is DBT - The Ultimate Data Build Tool.pdf
What is DBT - The Ultimate Data Build Tool.pdf
 
Commit 2024 - Secret Management made easy
Commit 2024 - Secret Management made easyCommit 2024 - Secret Management made easy
Commit 2024 - Secret Management made easy
 
New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
 
Tampa BSides - Chef's Tour of Microsoft Security Adoption Framework (SAF)
Tampa BSides - Chef's Tour of Microsoft Security Adoption Framework (SAF)Tampa BSides - Chef's Tour of Microsoft Security Adoption Framework (SAF)
Tampa BSides - Chef's Tour of Microsoft Security Adoption Framework (SAF)
 
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: Loan Stars - Tech Forum 2024
 
Moving Beyond Passwords: FIDO Paris Seminar.pdf
Moving Beyond Passwords: FIDO Paris Seminar.pdfMoving Beyond Passwords: FIDO Paris Seminar.pdf
Moving Beyond Passwords: FIDO Paris Seminar.pdf
 
Scanning the Internet for External Cloud Exposures via SSL Certs
Scanning the Internet for External Cloud Exposures via SSL CertsScanning the Internet for External Cloud Exposures via SSL Certs
Scanning the Internet for External Cloud Exposures via SSL Certs
 
Advanced Computer Architecture – An Introduction
Advanced Computer Architecture – An IntroductionAdvanced Computer Architecture – An Introduction
Advanced Computer Architecture – An Introduction
 
Use of FIDO in the Payments and Identity Landscape: FIDO Paris Seminar.pptx
Use of FIDO in the Payments and Identity Landscape: FIDO Paris Seminar.pptxUse of FIDO in the Payments and Identity Landscape: FIDO Paris Seminar.pptx
Use of FIDO in the Payments and Identity Landscape: FIDO Paris Seminar.pptx
 
SIP trunking in Janus @ Kamailio World 2024
SIP trunking in Janus @ Kamailio World 2024SIP trunking in Janus @ Kamailio World 2024
SIP trunking in Janus @ Kamailio World 2024
 
"Debugging python applications inside k8s environment", Andrii Soldatenko
"Debugging python applications inside k8s environment", Andrii Soldatenko"Debugging python applications inside k8s environment", Andrii Soldatenko
"Debugging python applications inside k8s environment", Andrii Soldatenko
 
How to write a Business Continuity Plan
How to write a Business Continuity PlanHow to write a Business Continuity Plan
How to write a Business Continuity Plan
 
Generative AI for Technical Writer or Information Developers
Generative AI for Technical Writer or Information DevelopersGenerative AI for Technical Writer or Information Developers
Generative AI for Technical Writer or Information Developers
 
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
Transcript: New from BookNet Canada for 2024: BNC CataList - Tech Forum 2024
 
Nell’iperspazio con Rocket: il Framework Web di Rust!
Nell’iperspazio con Rocket: il Framework Web di Rust!Nell’iperspazio con Rocket: il Framework Web di Rust!
Nell’iperspazio con Rocket: il Framework Web di Rust!
 
TrustArc Webinar - How to Build Consumer Trust Through Data Privacy
TrustArc Webinar - How to Build Consumer Trust Through Data PrivacyTrustArc Webinar - How to Build Consumer Trust Through Data Privacy
TrustArc Webinar - How to Build Consumer Trust Through Data Privacy
 
Dev Dives: Streamline document processing with UiPath Studio Web
Dev Dives: Streamline document processing with UiPath Studio WebDev Dives: Streamline document processing with UiPath Studio Web
Dev Dives: Streamline document processing with UiPath Studio Web
 

Documenting Design: A Critical Step in Any Developers Workflow

  • 1. documenting design a critical step in any developers work flow 9/19/2012 - LISA SABIN-WILSON
  • 2. Lisa Sabin-Wilson •DESIGNER SINCE 1998 •“DEVELOPER” SINCE 2003 •DEVELOPER SINCE 2007 •AUTHOR: WORDPRESS FOR DUMMIES •OWNER: EWEBSCAPES DESIGN STUDIO 9/19/2012 - LISA SABIN-WILSON
  • 3. documenting design ... 9/19/2012 - LISA SABIN-WILSON
  • 4. lives within that precious space between design & development 9/19/2012 - LISA SABIN-WILSON
  • 5. Let’s call it assumption alley - - because this is where MOST of the assumptions begin and then stick. 9/19/2012 - LISA SABIN-WILSON
  • 6. Eliminate Assumptions • Saves time • Reduces headaches • Avoids hard feelings • Happy client • Happy developer 9/19/2012 - LISA SABIN-WILSON
  • 7. Set Expectations Early • Keeps project realistic • Keeps projects on time • Avoids miscommunication • Happy client • Happy developer 9/19/2012 - LISA SABIN-WILSON
  • 8. Document Project Requirements • Ready reference point for all • Eliminates “he said/she said” • Provides a work flow • Happy client • Happy developer 9/19/2012 - LISA SABIN-WILSON
  • 9. NOT YOUR AVERAGE JOES PROJECT HTTP://NYAJ.COM DATE CLIENT JULY 2012 NOT YOUR AVERAGE JOES
  • 10. NOT YOUR AVERAGE JOE’S PROJECT HTTP://NYAJ.COM DATE CLIENT JULY 2012 NOT YOUR AVERAGE JOE’S
  • 11. INITIAL CLIENT CONTACT | PRE-SALES DISCUSSIONS | INITIAL REQUIREMENTS | Typical STATEMENT OF WORK | work flow DESIGN PROCESS | DESIGN APPROVAL | DEVELOPMENT | TESTING | GO LIVE! 9/19/2012 - LISA SABIN-WILSON
  • 12. INITIAL CLIENT CONTACT | PRE-SALES DISCUSSIONS | INITIAL REQUIREMENTS | New-Typical STATEMENT OF WORK | DESIGN PROCESS work flow | DESIGN DOCUMENTATION | DESIGN APPROVAL | DEVELOPMENT | TESTING | GO LIVE!
  • 13. documenting the design files eliminates the guess work. 9/19/2012 - LISA SABIN-WILSON
  • 14. WE BUILT A SITEMAP - WHICH WAS HELPFUL... BUT IT WASN’T ENOUGH 9/19/2012 - LISA SABIN-WILSON
  • 15. WE HAD A 16 PAGE STATEMENT OF WORK BUT IT STILL WASN’T ENOUGH 9/19/2012 - LISA SABIN-WILSON
  • 16. PSD Files Acquired. DESIGN APPROVAL DONE! 9/19/2012 - LISA SABIN-WILSON
  • 17. A TOTAL OF 26 DIFFERENT PAGE VIEWS/LAYOUTS BELIEVE IT OR NOT ... THIS WAS STILL NOT ENOUGH 9/19/2012 - LISA SABIN-WILSON
  • 18. at this point? it is really tempting to dig right in and start developing this bad boy. 9/19/2012 - LISA SABIN-WILSON
  • 19. the sooner you get it done... the sooner you get paid. the sooner you can update your portfolio. the sooner the client is happy. 9/19/2012 - LISA SABIN-WILSON
  • 20. right? 9/19/2012 - LISA SABIN-WILSON
  • 21. What they wanted... ? LISA NEEDS TO START DEVELOPMENT NOW BECAUSE WE WANT THIS DONE & LIVE IN LESS THAN 30 DAYS. 9/19/2012 - LISA SABIN-WILSON
  • 22. What they needed... ? STOP ... TAKE A BREATH ... LISA NEEDS TO DEFINE THE DEVELOPMENT IN A WAY THAT TAKES QUESTIONS OUT OF THE ENTIRE DEVELOPMENT PROCESS. 9/19/2012 - LISA SABIN-WILSON
  • 24. as a developer - I can make assumptions with the BEST of them
  • 25. assumptions are based on a persons own frame of reference.
  • 26. what i see in my head will be different from what you see in your head.
  • 29. THE LANDING PAGE THERE IS A LOT GOING ON HERE
  • 30. i made some assumptions :( 9/19/2012 - LISA SABIN-WILSON
  • 31. THE LANDING PAGE MORE PHOTOS? IT’S A SIDEBAR CAROUSEL - IT FLIPS THROUGH STAFF PHOTOS
  • 32. THE LANDING PAGE THE REALITY .... THE CLIENT’S INTENTION ? ...
  • 33. THE LANDING PAGE THE REALITY .... IT’S A SLIDESHOW/CAROUSEL OF PHOTOS IN THE MAIN BODY
  • 34. a sidebar carousel is HUGELY different than a slideshow in the main content area. 9/19/2012 - LISA SABIN-WILSON
  • 35. if i had gone with my initial assumption without discovering the clients intention ... 9/19/2012 - LISA SABIN-WILSON
  • 36. i would have wasted time. 9/19/2012 - LISA SABIN-WILSON
  • 37. i would have presented incorrect work to the client. 9/19/2012 - LISA SABIN-WILSON
  • 38. i would risk the client losing confidence in me. 9/19/2012 - LISA SABIN-WILSON
  • 39. especially if i had made my next assumption . . . 9/19/2012 - LISA SABIN-WILSON
  • 40. THE LANDING PAGE REMEMBER THIS? 9/19/2012 - LISA SABIN-WILSON
  • 41. THE LANDING PAGE JOIN OUR EMAIL CLUB - - LINKS TO A PAGE WITH A SUBSCRIPTION FORM - RIGHT?
  • 42. THE LANDING PAGE NOT EXACTLY - CLICK IT AND IT OPENS INLINE - NO NEW PAGE LOAD. 9/19/2012 - LISA SABIN-WILSON
  • 43. THE NAVIGATION MENU LINKS TO INTERNAL PAGES? 9/19/2012 - LISA SABIN-WILSON
  • 44. THE LANDING PAGE NOPE! IT CONTAINS A FLY OUT MENU WITH SUB NAVIGATION 9/19/2012 - LISA SABIN-WILSON
  • 45. none of this was indicated •INITIAL REQUIREMENTS •STATEMENT OF WORK •SITE MAP •PSD FILES 9/19/2012 - LISA SABIN-WILSON
  • 46. a smart developer •RECOGNIZES GAPS •ASKS QUESTIONS •SEEKS ANSWERS •REQUIRES CLARIFICATION 9/19/2012 - LISA SABIN-WILSON
  • 47. i have not always been a smart developer •WASTED HOURS UPON HOURS •FRUSTRATING BACK AND FORTH •LOST MONEY •FRUSTRATED CLIENTS •SCOPE CREEP •NEVER ENDING PROJECT 9/19/2012 - LISA SABIN-WILSON
  • 48. when you have your hands on the approved design files - get into the mind of the user 9/19/2012 - LISA SABIN-WILSON
  • 49. you know .... the person who is actually going to use the web site 9/19/2012 - LISA SABIN-WILSON
  • 50. you will do yourself and your client a favor if you start asking questions like... 9/19/2012 - LISA SABIN-WILSON
  • 51. what happens when I click this? 9/19/2012 - LISA SABIN-WILSON
  • 52. how many photos are loaded into this carousel? what happens when i click “more photos?” does clicking on an individual photo take me anywhere? 9/19/2012 - LISA SABIN-WILSON
  • 53. asking questions like these gives the client the chance to correct your assumptions... “oh no, that’s not for those photos ... it’s for the main photos on the left!” 9/19/2012 - LISA SABIN-WILSON
  • 54. so then you can clarify.... •HOW MANY PHOTOS? •ARE THEY LINKED TO ANYTHING? •ARE THESE POSTS WITH FEATURED IMAGES? •DOES THIS HAPPEN ON OTHER PAGES? •OR JUST THE HOME PAGE? 9/19/2012 - LISA SABIN-WILSON
  • 55. wherever there is an action indicated ... clarify it 9/19/2012 - LISA SABIN-WILSON
  • 56. Never be afraid to... ask questions get clarification correct your assumptions
  • 57. Doing so shows ... initiative motivation to do it right confidence thoroughness
  • 58. but wait .... don’t stop at simply having the conversation 9/19/2012 - LISA SABIN-WILSON
  • 59. document it. 9/19/2012 - LISA SABIN-WILSON
  • 60. make it part of the contract. 9/19/2012 - LISA SABIN-WILSON
  • 61. before you lay down one single piece of code - get your client to sign off on it. 9/19/2012 - LISA SABIN-WILSON
  • 62. find a method you prefer - but definitely document it 9/19/2012 - LISA SABIN-WILSON
  • 63. •AUDIO: RECORD THE CONVERSATION •OLD SCHOOL: SPREADSHEET •CONCEPT SHARE •HTTP://WWW.CONCEPTSHARE.COM •CAGE APP •HTTP://WWW.CAGEAPP.COM 9/19/2012 - LISA SABIN-WILSON
  • 64. whatever method you choose to use - make sure you document the process 9/19/2012 - LISA SABIN-WILSON
  • 65. Documenting each element in the project added approximately 2 hours. 9/19/2012 - LISA SABIN-WILSON
  • 66. if it wasn’t documented ... it didn’t happen 9/19/2012 - LISA SABIN-WILSON
  • 67. The End. 9/19/2012 - LISA SABIN-WILSON

Notas do Editor

  1. \n
  2. \n
  3. \n
  4. \n
  5. \n
  6. \n
  7. \n
  8. \n
  9. \n
  10. \n
  11. \n
  12. \n
  13. \n
  14. \n
  15. \n
  16. \n
  17. \n
  18. \n
  19. \n
  20. \n
  21. \n
  22. \n
  23. \n
  24. \n
  25. \n
  26. \n
  27. \n
  28. \n
  29. \n
  30. \n
  31. \n
  32. \n
  33. \n
  34. \n
  35. \n
  36. \n
  37. \n
  38. \n
  39. \n
  40. \n
  41. \n
  42. \n
  43. \n
  44. \n
  45. \n
  46. \n
  47. \n
  48. \n
  49. \n
  50. \n
  51. \n
  52. \n
  53. \n
  54. \n
  55. \n
  56. \n
  57. \n
  58. \n
  59. \n
  60. \n
  61. \n
  62. \n
  63. \n
  64. \n
  65. BEFORE NEXT SLIDE - In my years working as a Registered Nurse...we had a daily saying to remind us...\n
  66. \n
  67. \n