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
 
Seminar: Putting Mobile First
Seminar: Putting Mobile FirstSeminar: Putting Mobile First
Seminar: Putting Mobile First
 
Putting Mobile First
Putting Mobile FirstPutting Mobile First
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

Último (20)

Portal Kombat : extension du réseau de propagande russe
Portal Kombat : extension du réseau de propagande russePortal Kombat : extension du réseau de propagande russe
Portal Kombat : extension du réseau de propagande russe
 
TopCryptoSupers 12thReport OrionX May2024
TopCryptoSupers 12thReport OrionX May2024TopCryptoSupers 12thReport OrionX May2024
TopCryptoSupers 12thReport OrionX May2024
 
FDO for Camera, Sensor and Networking Device – Commercial Solutions from VinC...
FDO for Camera, Sensor and Networking Device – Commercial Solutions from VinC...FDO for Camera, Sensor and Networking Device – Commercial Solutions from VinC...
FDO for Camera, Sensor and Networking Device – Commercial Solutions from VinC...
 
WebAssembly is Key to Better LLM Performance
WebAssembly is Key to Better LLM PerformanceWebAssembly is Key to Better LLM Performance
WebAssembly is Key to Better LLM Performance
 
AI revolution and Salesforce, Jiří Karpíšek
AI revolution and Salesforce, Jiří KarpíšekAI revolution and Salesforce, Jiří Karpíšek
AI revolution and Salesforce, Jiří Karpíšek
 
Intro in Product Management - Коротко про професію продакт менеджера
Intro in Product Management - Коротко про професію продакт менеджераIntro in Product Management - Коротко про професію продакт менеджера
Intro in Product Management - Коротко про професію продакт менеджера
 
Extensible Python: Robustness through Addition - PyCon 2024
Extensible Python: Robustness through Addition - PyCon 2024Extensible Python: Robustness through Addition - PyCon 2024
Extensible Python: Robustness through Addition - PyCon 2024
 
TEST BANK For, Information Technology Project Management 9th Edition Kathy Sc...
TEST BANK For, Information Technology Project Management 9th Edition Kathy Sc...TEST BANK For, Information Technology Project Management 9th Edition Kathy Sc...
TEST BANK For, Information Technology Project Management 9th Edition Kathy Sc...
 
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdfHow Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
How Red Hat Uses FDO in Device Lifecycle _ Costin and Vitaliy at Red Hat.pdf
 
Speed Wins: From Kafka to APIs in Minutes
Speed Wins: From Kafka to APIs in MinutesSpeed Wins: From Kafka to APIs in Minutes
Speed Wins: From Kafka to APIs in Minutes
 
The Metaverse: Are We There Yet?
The  Metaverse:    Are   We  There  Yet?The  Metaverse:    Are   We  There  Yet?
The Metaverse: Are We There Yet?
 
Salesforce Adoption – Metrics, Methods, and Motivation, Antone Kom
Salesforce Adoption – Metrics, Methods, and Motivation, Antone KomSalesforce Adoption – Metrics, Methods, and Motivation, Antone Kom
Salesforce Adoption – Metrics, Methods, and Motivation, Antone Kom
 
Using IESVE for Room Loads Analysis - UK & Ireland
Using IESVE for Room Loads Analysis - UK & IrelandUsing IESVE for Room Loads Analysis - UK & Ireland
Using IESVE for Room Loads Analysis - UK & Ireland
 
Enterprise Knowledge Graphs - Data Summit 2024
Enterprise Knowledge Graphs - Data Summit 2024Enterprise Knowledge Graphs - Data Summit 2024
Enterprise Knowledge Graphs - Data Summit 2024
 
The Value of Certifying Products for FDO _ Paul at FIDO Alliance.pdf
The Value of Certifying Products for FDO _ Paul at FIDO Alliance.pdfThe Value of Certifying Products for FDO _ Paul at FIDO Alliance.pdf
The Value of Certifying Products for FDO _ Paul at FIDO Alliance.pdf
 
AI presentation and introduction - Retrieval Augmented Generation RAG 101
AI presentation and introduction - Retrieval Augmented Generation RAG 101AI presentation and introduction - Retrieval Augmented Generation RAG 101
AI presentation and introduction - Retrieval Augmented Generation RAG 101
 
ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...
ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...
ASRock Industrial FDO Solutions in Action for Industrial Edge AI _ Kenny at A...
 
Unpacking Value Delivery - Agile Oxford Meetup - May 2024.pptx
Unpacking Value Delivery - Agile Oxford Meetup - May 2024.pptxUnpacking Value Delivery - Agile Oxford Meetup - May 2024.pptx
Unpacking Value Delivery - Agile Oxford Meetup - May 2024.pptx
 
Where to Learn More About FDO _ Richard at FIDO Alliance.pdf
Where to Learn More About FDO _ Richard at FIDO Alliance.pdfWhere to Learn More About FDO _ Richard at FIDO Alliance.pdf
Where to Learn More About FDO _ Richard at FIDO Alliance.pdf
 
Syngulon - Selection technology May 2024.pdf
Syngulon - Selection technology May 2024.pdfSyngulon - Selection technology May 2024.pdf
Syngulon - Selection technology May 2024.pdf
 

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