SlideShare uma empresa Scribd logo
1 de 18
Writing for Mobile
Rewrite? Cut?
Who Am I?
 Neil

Perlin - Hyper/Word Services.

– Internationally recognized content creation and
delivery consultant.
– Help clients create effective, efficient, flexible
content in anything from print to mobile.
– Writing for online since 1986.
– Working with mobile since Windows CE and
WML/WAP c. 1998
– Certified – Viziapps, Flare, Mimic, RoboHelp.
The Issues
 How

should we write for mobile?

– Rewrite our existing material?
– Cut our existing material?
 Question

goes beyond “writing” alone due
to technical side of today‟s tech comm.
– A more complex version of the “no dumping”
theme of the early „90s.

 Must

first define “mobile” in your context.
What is “Mobile”?
What is “Mobile”?

 “Mobile”

is essentially = the “undesktop”

» Images from 99designs.com, biblog.arcplan.com
What Type of Mobile?
 If

apps, they‟re usually
function-centric.
 Differ from “normal”
tech comm…
What Type of Mobile?
 But

some apps are contentcentric, effectively tech comm.
– With a lot of text in this case.
What Type of Mobile?
 What

about this?
So Can We Write for Mobile?
 Yes,

depending on what mobile we mean.

– A laptop is a PC.
– A tablet is a small laptop without a keyboard,
can show PC-type content in browser windows.
– A smartphone is completely different.
 And

depending on whether we‟re talking
about:
– Web apps – browser-based.
– Native/hybrid apps – platform-based or both.
A Design Fix For the Undesktop
design – display-agnosticism.
 For example, from RoboHelp 11.
 Responsive
But Consider…
 Cross-device/format/authoring

tool issues:

– Images may be too wide for phone screens.
» Can size them relatively to fit available screen.
» But are they still legible?
» If not, can you conditionalize them out?
» If you do, does that affect the content?
» May call for greater granularity of content…
» And need a CMS to deal with the greater # of
content chunks even if traditional help did not.

– Ditto tables.
More…
– Consider SWFs.
» Won‟t run on iOS – must be MP4 or HTML5.
» Are text captions legible or must you replace them
with audio = creating 2+ versions of each movie.
» What happens to interactivity with no mouse?

– Minimal table support in ebook formats.
– “Invisible” problems of content in snippets.
– And more…
Dealing With Text-Heaviness
down text – not fat but real text – to
the bare bones, such as:

 Cut

–
–
–
–

If 1, land.
If 2, sea.
Ride.
Spread alarm.
» With apologies to Henry Wadsworth Longfellow
and The Midnight Ride of Paul Revere.
Dealing With Text-Heaviness
 Have

you reviewed your content lately for
legacy content?
– Mechanical, like how to use a mouse?
– Domain knowledge, like accounting principles
in accounting software?
– Stuff that‟s just no longer applicable?

 Can

you delete content that may not apply
to mobile but that may still be necessary?
 If so, where do you put it? For example…
The Battle of the Sunda Straits
 Created

a multimedia project in „93 about a
little-known naval battle from 1942.
– Had 15 frames describing the action, with ~30
paragraphs of text.
– Boiled down from 75 pages in Morrison‟s
History of US Naval Operations in WW2.
– No web in „93, so the cut 70+ pages were lost.
– Can your cut material be made available if
users need it?
Summary – Rewrite or Cut?
 Both.

– Cut to shorten the content and to account for
technical limitations or requirements.
» But make the content available if still important.

– Rewrite the remainder to account for the cuts
and to improve the writing in general.
 We

still want good writing, just less of it
and more focused on the user‟s needs.
Hyper/Word Services Offers…
Training • Consulting • Development
 Flare • Flare CSS • Flare Single Sourcing
 RoboHelp • RoboHelp CSS • RoboHelp
HTML5
 ViziApps
 Single sourcing • Structured authoring
Thank you... Questions?

978-657-5464
nperlin@nperlin.cnc.net
www.hyperword.com
Twitter: NeilEric

Mais conteúdo relacionado

Semelhante a Tc dojo presentation writing mobile documentation

Overcoming design challenges in HAT-based multichannel publishing
Overcoming design challenges in HAT-based multichannel publishingOvercoming design challenges in HAT-based multichannel publishing
Overcoming design challenges in HAT-based multichannel publishing
Jack Molisani
 
Creating Mobile Aps without Coding
Creating Mobile Aps without CodingCreating Mobile Aps without Coding
Creating Mobile Aps without Coding
Jack Molisani
 

Semelhante a Tc dojo presentation writing mobile documentation (20)

Overcoming Design Challenges in HAT-Based Multichannel Publishing
Overcoming Design Challenges in HAT-Based Multichannel PublishingOvercoming Design Challenges in HAT-Based Multichannel Publishing
Overcoming Design Challenges in HAT-Based Multichannel Publishing
 
Overcoming design challenges in HAT-based multichannel publishing
Overcoming design challenges in HAT-based multichannel publishingOvercoming design challenges in HAT-based multichannel publishing
Overcoming design challenges in HAT-based multichannel publishing
 
Overcoming design challenges in hat based multichannel publishing - stc summi...
Overcoming design challenges in hat based multichannel publishing - stc summi...Overcoming design challenges in hat based multichannel publishing - stc summi...
Overcoming design challenges in hat based multichannel publishing - stc summi...
 
Overcoming design challenges in hat based multichannel publishing - stc summi...
Overcoming design challenges in hat based multichannel publishing - stc summi...Overcoming design challenges in hat based multichannel publishing - stc summi...
Overcoming design challenges in hat based multichannel publishing - stc summi...
 
Stc 2015 preparing legacy projects for responsive design - design issues
Stc 2015   preparing legacy projects for responsive design - design issuesStc 2015   preparing legacy projects for responsive design - design issues
Stc 2015 preparing legacy projects for responsive design - design issues
 
Spectrum 16 pmc 16 - mobile and tech comm
Spectrum 16   pmc 16 - mobile and tech commSpectrum 16   pmc 16 - mobile and tech comm
Spectrum 16 pmc 16 - mobile and tech comm
 
Neil Perlin - We're Going Mobile! Great! Are We Ready?
Neil Perlin - We're Going Mobile! Great! Are We Ready?Neil Perlin - We're Going Mobile! Great! Are We Ready?
Neil Perlin - We're Going Mobile! Great! Are We Ready?
 
We’re Going Mobile! Great! Wait… What Does That Mean?
We’re Going Mobile! Great! Wait… What Does That Mean?We’re Going Mobile! Great! Wait… What Does That Mean?
We’re Going Mobile! Great! Wait… What Does That Mean?
 
Stc 2015 preparing legacy projects for responsive design - technical issues
Stc 2015   preparing legacy projects for responsive design - technical issuesStc 2015   preparing legacy projects for responsive design - technical issues
Stc 2015 preparing legacy projects for responsive design - technical issues
 
Uxpin web ui design patterns 2014
Uxpin web ui design patterns 2014Uxpin web ui design patterns 2014
Uxpin web ui design patterns 2014
 
Web UI Design Patterns 2014
Web UI Design Patterns 2014Web UI Design Patterns 2014
Web UI Design Patterns 2014
 
Putting Mobile First
Putting Mobile FirstPutting Mobile First
Putting Mobile First
 
Seminar: Putting Mobile First
Seminar: Putting Mobile FirstSeminar: Putting Mobile First
Seminar: Putting Mobile First
 
Bank Chris - Web UI Design Patterns - 2014
Bank Chris - Web UI Design Patterns - 2014Bank Chris - Web UI Design Patterns - 2014
Bank Chris - Web UI Design Patterns - 2014
 
Creating Mobile Aps without Coding
Creating Mobile Aps without CodingCreating Mobile Aps without Coding
Creating Mobile Aps without Coding
 
What’s Up, EDoc?!
What’s Up,EDoc?!What’s Up,EDoc?!
What’s Up, EDoc?!
 
Responsive webdesign WordCampNL 2012
Responsive webdesign WordCampNL 2012Responsive webdesign WordCampNL 2012
Responsive webdesign WordCampNL 2012
 
Ready to go Mobile? Today's Mobile Landscape: Responsive, Adaptive, Hybrid, a...
Ready to go Mobile? Today's Mobile Landscape: Responsive, Adaptive, Hybrid, a...Ready to go Mobile? Today's Mobile Landscape: Responsive, Adaptive, Hybrid, a...
Ready to go Mobile? Today's Mobile Landscape: Responsive, Adaptive, Hybrid, a...
 
Introduction to ePublishing
Introduction to ePublishingIntroduction to ePublishing
Introduction to ePublishing
 
Pragmatic Principles for Mobile Design
Pragmatic Principles for Mobile DesignPragmatic Principles for Mobile Design
Pragmatic Principles for Mobile Design
 

Mais de Neil Perlin

Rh10 css presentation
Rh10 css presentationRh10 css presentation
Rh10 css presentation
Neil Perlin
 
Small steps to content strategy
Small steps to content strategySmall steps to content strategy
Small steps to content strategy
Neil Perlin
 
Topic based and structured authoring - slides
Topic based and structured authoring - slidesTopic based and structured authoring - slides
Topic based and structured authoring - slides
Neil Perlin
 

Mais de Neil Perlin (13)

Spectrum 2015 responsive design
Spectrum 2015   responsive designSpectrum 2015   responsive design
Spectrum 2015 responsive design
 
Spectrum 2015 going online with style - an intro to css
Spectrum 2015   going online with style - an intro to cssSpectrum 2015   going online with style - an intro to css
Spectrum 2015 going online with style - an intro to css
 
Lavacon 2014 responsive design in your hat
Lavacon 2014   responsive design in your hatLavacon 2014   responsive design in your hat
Lavacon 2014 responsive design in your hat
 
Rh10 css presentation
Rh10 css presentationRh10 css presentation
Rh10 css presentation
 
Rh10 css presentation
Rh10 css presentationRh10 css presentation
Rh10 css presentation
 
Integrating hat content into mobile app lavacon
Integrating hat content into mobile app   lavaconIntegrating hat content into mobile app   lavacon
Integrating hat content into mobile app lavacon
 
Developing for the unknown lavacon
Developing for the unknown   lavaconDeveloping for the unknown   lavacon
Developing for the unknown lavacon
 
Developing for the unknown lavacon
Developing for the unknown   lavaconDeveloping for the unknown   lavacon
Developing for the unknown lavacon
 
Small steps to content strategy
Small steps to content strategySmall steps to content strategy
Small steps to content strategy
 
Small steps to content strategy
Small steps to content strategySmall steps to content strategy
Small steps to content strategy
 
Single sourcing to the max
Single sourcing to the maxSingle sourcing to the max
Single sourcing to the max
 
Topic based and structured authoring - slides
Topic based and structured authoring - slidesTopic based and structured authoring - slides
Topic based and structured authoring - slides
 
Topic based and structured authoring - slides
Topic based and structured authoring - slidesTopic based and structured authoring - slides
Topic based and structured authoring - slides
 

Último

Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Safe Software
 
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Safe Software
 

Último (20)

Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
 
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data DiscoveryTrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
 
Strategies for Landing an Oracle DBA Job as a Fresher
Strategies for Landing an Oracle DBA Job as a FresherStrategies for Landing an Oracle DBA Job as a Fresher
Strategies for Landing an Oracle DBA Job as a Fresher
 
Polkadot JAM Slides - Token2049 - By Dr. Gavin Wood
Polkadot JAM Slides - Token2049 - By Dr. Gavin WoodPolkadot JAM Slides - Token2049 - By Dr. Gavin Wood
Polkadot JAM Slides - Token2049 - By Dr. Gavin Wood
 
Biography Of Angeliki Cooney | Senior Vice President Life Sciences | Albany, ...
Biography Of Angeliki Cooney | Senior Vice President Life Sciences | Albany, ...Biography Of Angeliki Cooney | Senior Vice President Life Sciences | Albany, ...
Biography Of Angeliki Cooney | Senior Vice President Life Sciences | Albany, ...
 
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
 
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
 
Repurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost Saving
Repurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost SavingRepurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost Saving
Repurposing LNG terminals for Hydrogen Ammonia: Feasibility and Cost Saving
 
Apidays New York 2024 - Accelerating FinTech Innovation by Vasa Krishnan, Fin...
Apidays New York 2024 - Accelerating FinTech Innovation by Vasa Krishnan, Fin...Apidays New York 2024 - Accelerating FinTech Innovation by Vasa Krishnan, Fin...
Apidays New York 2024 - Accelerating FinTech Innovation by Vasa Krishnan, Fin...
 
Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...
 
2024: Domino Containers - The Next Step. News from the Domino Container commu...
2024: Domino Containers - The Next Step. News from the Domino Container commu...2024: Domino Containers - The Next Step. News from the Domino Container commu...
2024: Domino Containers - The Next Step. News from the Domino Container commu...
 
AWS Community Day CPH - Three problems of Terraform
AWS Community Day CPH - Three problems of TerraformAWS Community Day CPH - Three problems of Terraform
AWS Community Day CPH - Three problems of Terraform
 
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot TakeoffStrategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
 
EMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWER
EMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWEREMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWER
EMPOWERMENT TECHNOLOGY GRADE 11 QUARTER 2 REVIEWER
 
MS Copilot expands with MS Graph connectors
MS Copilot expands with MS Graph connectorsMS Copilot expands with MS Graph connectors
MS Copilot expands with MS Graph connectors
 
Axa Assurance Maroc - Insurer Innovation Award 2024
Axa Assurance Maroc - Insurer Innovation Award 2024Axa Assurance Maroc - Insurer Innovation Award 2024
Axa Assurance Maroc - Insurer Innovation Award 2024
 
presentation ICT roal in 21st century education
presentation ICT roal in 21st century educationpresentation ICT roal in 21st century education
presentation ICT roal in 21st century education
 
Artificial Intelligence Chap.5 : Uncertainty
Artificial Intelligence Chap.5 : UncertaintyArtificial Intelligence Chap.5 : Uncertainty
Artificial Intelligence Chap.5 : Uncertainty
 
Apidays New York 2024 - APIs in 2030: The Risk of Technological Sleepwalk by ...
Apidays New York 2024 - APIs in 2030: The Risk of Technological Sleepwalk by ...Apidays New York 2024 - APIs in 2030: The Risk of Technological Sleepwalk by ...
Apidays New York 2024 - APIs in 2030: The Risk of Technological Sleepwalk by ...
 
CNIC Information System with Pakdata Cf In Pakistan
CNIC Information System with Pakdata Cf In PakistanCNIC Information System with Pakdata Cf In Pakistan
CNIC Information System with Pakdata Cf In Pakistan
 

Tc dojo presentation writing mobile documentation

  • 2. Who Am I?  Neil Perlin - Hyper/Word Services. – Internationally recognized content creation and delivery consultant. – Help clients create effective, efficient, flexible content in anything from print to mobile. – Writing for online since 1986. – Working with mobile since Windows CE and WML/WAP c. 1998 – Certified – Viziapps, Flare, Mimic, RoboHelp.
  • 3. The Issues  How should we write for mobile? – Rewrite our existing material? – Cut our existing material?  Question goes beyond “writing” alone due to technical side of today‟s tech comm. – A more complex version of the “no dumping” theme of the early „90s.  Must first define “mobile” in your context.
  • 5. What is “Mobile”?  “Mobile” is essentially = the “undesktop” » Images from 99designs.com, biblog.arcplan.com
  • 6. What Type of Mobile?  If apps, they‟re usually function-centric.  Differ from “normal” tech comm…
  • 7. What Type of Mobile?  But some apps are contentcentric, effectively tech comm. – With a lot of text in this case.
  • 8. What Type of Mobile?  What about this?
  • 9. So Can We Write for Mobile?  Yes, depending on what mobile we mean. – A laptop is a PC. – A tablet is a small laptop without a keyboard, can show PC-type content in browser windows. – A smartphone is completely different.  And depending on whether we‟re talking about: – Web apps – browser-based. – Native/hybrid apps – platform-based or both.
  • 10. A Design Fix For the Undesktop design – display-agnosticism.  For example, from RoboHelp 11.  Responsive
  • 11. But Consider…  Cross-device/format/authoring tool issues: – Images may be too wide for phone screens. » Can size them relatively to fit available screen. » But are they still legible? » If not, can you conditionalize them out? » If you do, does that affect the content? » May call for greater granularity of content… » And need a CMS to deal with the greater # of content chunks even if traditional help did not. – Ditto tables.
  • 12. More… – Consider SWFs. » Won‟t run on iOS – must be MP4 or HTML5. » Are text captions legible or must you replace them with audio = creating 2+ versions of each movie. » What happens to interactivity with no mouse? – Minimal table support in ebook formats. – “Invisible” problems of content in snippets. – And more…
  • 13. Dealing With Text-Heaviness down text – not fat but real text – to the bare bones, such as:  Cut – – – – If 1, land. If 2, sea. Ride. Spread alarm. » With apologies to Henry Wadsworth Longfellow and The Midnight Ride of Paul Revere.
  • 14. Dealing With Text-Heaviness  Have you reviewed your content lately for legacy content? – Mechanical, like how to use a mouse? – Domain knowledge, like accounting principles in accounting software? – Stuff that‟s just no longer applicable?  Can you delete content that may not apply to mobile but that may still be necessary?  If so, where do you put it? For example…
  • 15. The Battle of the Sunda Straits  Created a multimedia project in „93 about a little-known naval battle from 1942. – Had 15 frames describing the action, with ~30 paragraphs of text. – Boiled down from 75 pages in Morrison‟s History of US Naval Operations in WW2. – No web in „93, so the cut 70+ pages were lost. – Can your cut material be made available if users need it?
  • 16. Summary – Rewrite or Cut?  Both. – Cut to shorten the content and to account for technical limitations or requirements. » But make the content available if still important. – Rewrite the remainder to account for the cuts and to improve the writing in general.  We still want good writing, just less of it and more focused on the user‟s needs.
  • 17. Hyper/Word Services Offers… Training • Consulting • Development  Flare • Flare CSS • Flare Single Sourcing  RoboHelp • RoboHelp CSS • RoboHelp HTML5  ViziApps  Single sourcing • Structured authoring