SlideShare a Scribd company logo
Balancing standardization against
the need for creativity
Flickr: Paxson Woelber
Alan Pringle
Scriptorium
August 3, 2016
@alanpringle
Type questions and
comments in the
Questions module of
GoToWebinar.
Questions? Comments?
Flickr: Veronique Debord
Attendees are muted
during webcast.
Webcast is being recorded,
but your name won't be
shown.
@alanpringle
About me
Chief operating officer,
Scriptorium Publishing
Working with structured
content since 1988
Coauthor, Content Strategy 101
and Technical Writing 101
@alanpringle
About me
@alanpringle
Stereotype of structured authoring
Flickr: Umberto Salvagnin
No creativity!
@alanpringle
Three case studies
Communicating layout specifications for
automated outputs
Considering the true costs of customized
structures
Flexibility in layout as a business
requirement
@alanpringle
Flickr: State Library and Archives of Florida
Communicating layout specifications for
automated output
@alanpringle
Communicating layout specifications for
automated output
@alanpringle
Communicating layout specifications for
automated output
<xsl:variable name="level-1-family">SansBold</xsl:variable>
<xsl:variable name="level-1-size">14pt</xsl:variable>
<xsl:variable name="level-1-line-height">15pt</xsl:variable>
<xsl:variable name="level-1-weight">normal</xsl:variable>
<xsl:variable name="level-1-style">normal</xsl:variable>
<xsl:variable name="level-1-indent">0pt</xsl:variable>
<xsl:variable name="level-1-color">#000000</xsl:variable>
<xsl:variable name="level-1-space-before">42pt</xsl:variable>
<xsl:variable name="level-1-space-after">4pt</xsl:variable>
Settings for heading 1 paragraphs:
@alanpringle
Communicating layout specifications for
automated output
Typical workflow for automated PDF output
@alanpringle
Communicating layout specifications for
automated output
Programmer develops stylesheet in
text/XML editor.
Code specifies page size, font use, and
so on.
@alanpringle
Communicating layout specifications for
automated output
<xsl:variable name="level-1-family">SansBold</xsl:variable>
<xsl:variable name="level-1-size">14pt</xsl:variable>
<xsl:variable name="level-1-line-height">15pt</xsl:variable>
<xsl:variable name="level-1-weight">normal</xsl:variable>
<xsl:variable name="level-1-style">normal</xsl:variable>
<xsl:variable name="level-1-indent">0pt</xsl:variable>
<xsl:variable name="level-1-color">#000000</xsl:variable>
<xsl:variable name="level-1-space-before">42pt</xsl:variable>
<xsl:variable name="level-1-space-after">4pt</xsl:variable>
@alanpringle
Communicating layout specifications for
automated output
Any changes?
“Change the heading color to our new
corporate blue.”
“Make the chapter heading a little bigger.”
Programmer gets specifications from
template.
@alanpringle
Communicating layout specifications for
automated output
Developed process that relies on... stylesheets!
Programmer added detailed code comments.
Programmatic formatting requires specific
numbers. How do you collect them?
@alanpringle
Communicating layout specifications for
automated output
Sample code comment for page size:
Physical page dimensions.
US Letter is 8.5 in x 11 in;
A4 is 8.3 in × 11.7 in.
Dimensions that accommodate
both paper sizes are 8.3 in x
11.0 in.
@alanpringle
Communicating layout specifications for
automated output
Extract code comments and create Word
file:
@alanpringle
Communicating layout specifications for
automated output
Designer fills out settings and returns file.
Programmer gets specific measurements.
Code comments serve as reference for
later maintenance.
@alanpringle
Flexibility in layout as a
business requirement
Flickr: Creative-Tools.com
@alanpringle
Flexibility in layout as a
business requirement
Automated PDF formatting is not for all
information types.
Highly designed study guides required
greater flexibility in layout.
How do you preserve high-quality layouts
for print?
@alanpringle
Flexibility in layout as a
business requirement
Transform source XML into InDesign-
compatible XML.
XML refers to styles in the InDesign
template.
@alanpringle
Flexibility in layout as a
business requirement
<ParagraphStyleRange AppliedParagraphStyle="ParagraphStyle/body">
<CharacterStyleRange AppliedCharacterStyle="CharacterStyle/
$ID/[No character style]">
<Content>When developing a test bed, it is important to
ensure that you cover </Content>
</CharacterStyleRange>
<CharacterStyleRange
AppliedCharacterStyle="CharacterStyle/bold">
<Content>all </Content>
</CharacterStyleRange>
<CharacterStyleRange AppliedCharacterStyle="CharacterStyle/
$ID/[No character style]">
<Content>basic cases for your requirements.</Content>
</CharacterStyleRange>
...
</ParagraphStyleRange>
InDesign Markup Language (IDML) sample:
@alanpringle
Flexibility in layout as a
business requirement
Place XML file into InDesign template.
Styles and other formatting applied
automatically:
@alanpringle
Flexibility in layout as a
business requirement
@alanpringle
Wikipedia: Guma89
Flexibility in layout as a
business requirement
Adjust line breaks, pagination, image
placement, and so on.
Reduced production time significantly.
Get benefits of structured content (reuse,
in particular).
@alanpringle
Considering the true costs of
customized structures
Flickr: Japanexperterna.se
@alanpringle
Considering the true costs of
customized structures
Standardization versus creativity is not
just about layout.
Create custom structure? Adopt standard?
When should you change a standard's
default structures?
@alanpringle
Considering the true costs of
customized structures
Implement XML for conditional content,
mobile delivery, and localization.
Installation guides: procedures with more
than 100 steps.
Steps could contain substeps and
sub-substeps.
@alanpringle
Considering the true costs of
customized structures
Procedure layers:
63. This is the 63rd
step in a procedure.
a. This is a substep.
i. This is a sub-substep.
@alanpringle
Considering the true costs of
customized structures
Content model did not support sub-substeps
by default.
Content creators requested addition of
sub-substep element.
@alanpringle
Considering the true costs of
customized structures
My reaction to a 100-step procedure with
three layers of steps:
a. Time to re-evaluate
b. Excellent tech comm
c. Absolutely not
d. CENSORED
@alanpringle
Considering the true costs of
customized structures
Information architects: reconsider the long
procedures and sub-substeps.
Level of effort: modifying versus
maintaining default structure.
@alanpringle
Please.
Considering the true costs of
customized structures
Modify:

Develop and test modification

Implement in authoring tools, CCMS, and
stylesheets

Distribute to localization vendors

Train writers on custom structure
@alanpringle
Considering the true costs of
customized structures
Maintain:

Rethink procedures to eliminate sub-substeps.

Rewrite to break up lengthy procedures.
@alanpringle
Considering the true costs of
customized structures
Content creators:
Did not want to rewrite content.
Adding sub-substep path of least resistance.
Rewriting = admitting that process is bad.
@alanpringle
Considering the true costs of
customized structures
Information architects:
Rewriting: short-term effort, long-term
benefits.
Rewrote some content to show increased
reuse.
What about reading on phones and
tablets?
@alanpringle
Considering the true costs of
customized structures
@alanpringle
Considering the true costs of
customized structures
No agreement on approach.
Company planned to re-evaluate later.
Not every consulting engagement has a
happy ending.
@alanpringle
Conclusions
Streamline communication with technology.
Evaluate costs and biases while considering
structural changes.
Get benefits of structure and flexible
formatting.
@alanpringle
Conclusions
Technical ≠ not creative
Need versus want
@alanpringle
Resources
PDF specifications (Word file)
tiny.cc/PDFsettings
Managing change (Content Strategy 101)
tiny.cc/manage-change
InDesign XML
InDesign & DITA post: tiny.cc/indesign-dita
IDML specifications (PDF): tiny.cc/idml
@alanpringle
Resources
Case study summaries:
tiny.cc/balancing-case-studies
@alanpringle
Flickr: Veronique Debord
Questions?
Comments?
@alanpringle
Contact me
Alan Pringle
asp@scriptorium.com
scriptorium.com/blog
@alanpringle

More Related Content

PDF
Dev days Szeged 2014: Plugin system in drupal 8
PPTX
Resistance is futile: Start writing accessible websites now!
PPTX
Simple Vapour Compression Refrigeration System
PDF
GenAI-powered assistants compared in a real case - 2025-03-18
PPTX
Let us understand design pattern
PPTX
Content query web part – get it all in one place and style it!
PDF
Recsys 2016
PDF
Software Patterns
Dev days Szeged 2014: Plugin system in drupal 8
Resistance is futile: Start writing accessible websites now!
Simple Vapour Compression Refrigeration System
GenAI-powered assistants compared in a real case - 2025-03-18
Let us understand design pattern
Content query web part – get it all in one place and style it!
Recsys 2016
Software Patterns

Similar to Webcast: Balancing standardization against the need for creativity (20)

PDF
Building Responsive Applications Using XPages
PDF
Java Design Patterns Tutorial | Edureka
PPTX
Business system analyst workbook
PDF
Tech leaders guide to effective building of machine learning products
PDF
Artificial Intelligence for XMLDevelopment
PPT
Drupal Camp Victoria
PDF
Full download Responsive Web Design with HTML5 and CSS3 Second Edition Ben Fr...
PDF
Machine learning at scale challenges and solutions
PDF
Technical-design-for-Angular-apps.pdf
PDF
The Why and What of Pattern Lab
PDF
Stencil the time for vanilla web components has arrived
PPTX
Onion Architecture with S#arp
PPTX
Software engineering practices for the data science and machine learning life...
PPT
Developing sites with Magnolia 4 / STK
PDF
Apache ® Spark™ MLlib 2.x: How to Productionize your Machine Learning Models
DOCX
Xaml Guidelines Draft0
PPTX
L03 Design Patterns
PPTX
Top tips from what we've learned from our 10 years experience
PDF
presentation
PDF
CUST-3 Document Management with Share
Building Responsive Applications Using XPages
Java Design Patterns Tutorial | Edureka
Business system analyst workbook
Tech leaders guide to effective building of machine learning products
Artificial Intelligence for XMLDevelopment
Drupal Camp Victoria
Full download Responsive Web Design with HTML5 and CSS3 Second Edition Ben Fr...
Machine learning at scale challenges and solutions
Technical-design-for-Angular-apps.pdf
The Why and What of Pattern Lab
Stencil the time for vanilla web components has arrived
Onion Architecture with S#arp
Software engineering practices for the data science and machine learning life...
Developing sites with Magnolia 4 / STK
Apache ® Spark™ MLlib 2.x: How to Productionize your Machine Learning Models
Xaml Guidelines Draft0
L03 Design Patterns
Top tips from what we've learned from our 10 years experience
presentation
CUST-3 Document Management with Share
Ad

More from Scriptorium Publishing (20)

PDF
Think global, act global, go global
PDF
Future-proofing your content
PDF
Future-proofing your career
PDF
Developing training websites in multiple languages with (mostly) open-source ...
PDF
The Rocky Road to DITA
PDF
LavaCon keynote: But Father, I'm Goldleafing as Fast as I Can!
PDF
2016 content trends
PDF
Unified Content Development: Integrating Tech Comm, Marcom, and Technical Sup...
PDF
Content Strategy Triage: Who lives? Who dies? Who do you fight to save?
PDF
Content Strategy Triage: Extended Edition
PDF
The Content Strategy of Things
PDF
Localization strategy and the customer journey
PDF
Webinar content strategy_vs_the_undead
PDF
Content strategy triage intro for Lavacon 2015
PDF
2015 content trends
PDF
Adapting content for the US market
PDF
Content strategy vs. The Undead
PDF
The many facets of content strategy
PDF
The Bottom Line: Globalization and the Dependence on Intelligent Content
PDF
The many facets of content strategy
Think global, act global, go global
Future-proofing your content
Future-proofing your career
Developing training websites in multiple languages with (mostly) open-source ...
The Rocky Road to DITA
LavaCon keynote: But Father, I'm Goldleafing as Fast as I Can!
2016 content trends
Unified Content Development: Integrating Tech Comm, Marcom, and Technical Sup...
Content Strategy Triage: Who lives? Who dies? Who do you fight to save?
Content Strategy Triage: Extended Edition
The Content Strategy of Things
Localization strategy and the customer journey
Webinar content strategy_vs_the_undead
Content strategy triage intro for Lavacon 2015
2015 content trends
Adapting content for the US market
Content strategy vs. The Undead
The many facets of content strategy
The Bottom Line: Globalization and the Dependence on Intelligent Content
The many facets of content strategy
Ad

Recently uploaded (20)

PPTX
cloud_computing_Infrastucture_as_cloud_p
PDF
August Patch Tuesday
PDF
Profit Center Accounting in SAP S/4HANA, S4F28 Col11
PDF
Getting Started with Data Integration: FME Form 101
PDF
Univ-Connecticut-ChatGPT-Presentaion.pdf
PDF
A comparative analysis of optical character recognition models for extracting...
PPTX
Group 1 Presentation -Planning and Decision Making .pptx
PPT
Teaching material agriculture food technology
PPTX
Tartificialntelligence_presentation.pptx
PPTX
OMC Textile Division Presentation 2021.pptx
PDF
Heart disease approach using modified random forest and particle swarm optimi...
PPTX
KOM of Painting work and Equipment Insulation REV00 update 25-dec.pptx
PDF
Accuracy of neural networks in brain wave diagnosis of schizophrenia
PDF
Architecting across the Boundaries of two Complex Domains - Healthcare & Tech...
PDF
Network Security Unit 5.pdf for BCA BBA.
PDF
Video forgery: An extensive analysis of inter-and intra-frame manipulation al...
PDF
Advanced methodologies resolving dimensionality complications for autism neur...
PDF
Unlocking AI with Model Context Protocol (MCP)
PDF
Encapsulation theory and applications.pdf
PPTX
TLE Review Electricity (Electricity).pptx
cloud_computing_Infrastucture_as_cloud_p
August Patch Tuesday
Profit Center Accounting in SAP S/4HANA, S4F28 Col11
Getting Started with Data Integration: FME Form 101
Univ-Connecticut-ChatGPT-Presentaion.pdf
A comparative analysis of optical character recognition models for extracting...
Group 1 Presentation -Planning and Decision Making .pptx
Teaching material agriculture food technology
Tartificialntelligence_presentation.pptx
OMC Textile Division Presentation 2021.pptx
Heart disease approach using modified random forest and particle swarm optimi...
KOM of Painting work and Equipment Insulation REV00 update 25-dec.pptx
Accuracy of neural networks in brain wave diagnosis of schizophrenia
Architecting across the Boundaries of two Complex Domains - Healthcare & Tech...
Network Security Unit 5.pdf for BCA BBA.
Video forgery: An extensive analysis of inter-and intra-frame manipulation al...
Advanced methodologies resolving dimensionality complications for autism neur...
Unlocking AI with Model Context Protocol (MCP)
Encapsulation theory and applications.pdf
TLE Review Electricity (Electricity).pptx

Webcast: Balancing standardization against the need for creativity

  • 1. Balancing standardization against the need for creativity Flickr: Paxson Woelber Alan Pringle Scriptorium August 3, 2016 @alanpringle
  • 2. Type questions and comments in the Questions module of GoToWebinar. Questions? Comments? Flickr: Veronique Debord Attendees are muted during webcast. Webcast is being recorded, but your name won't be shown. @alanpringle
  • 3. About me Chief operating officer, Scriptorium Publishing Working with structured content since 1988 Coauthor, Content Strategy 101 and Technical Writing 101 @alanpringle
  • 5. Stereotype of structured authoring Flickr: Umberto Salvagnin No creativity! @alanpringle
  • 6. Three case studies Communicating layout specifications for automated outputs Considering the true costs of customized structures Flexibility in layout as a business requirement @alanpringle
  • 7. Flickr: State Library and Archives of Florida Communicating layout specifications for automated output @alanpringle
  • 8. Communicating layout specifications for automated output @alanpringle
  • 9. Communicating layout specifications for automated output <xsl:variable name="level-1-family">SansBold</xsl:variable> <xsl:variable name="level-1-size">14pt</xsl:variable> <xsl:variable name="level-1-line-height">15pt</xsl:variable> <xsl:variable name="level-1-weight">normal</xsl:variable> <xsl:variable name="level-1-style">normal</xsl:variable> <xsl:variable name="level-1-indent">0pt</xsl:variable> <xsl:variable name="level-1-color">#000000</xsl:variable> <xsl:variable name="level-1-space-before">42pt</xsl:variable> <xsl:variable name="level-1-space-after">4pt</xsl:variable> Settings for heading 1 paragraphs: @alanpringle
  • 10. Communicating layout specifications for automated output Typical workflow for automated PDF output @alanpringle
  • 11. Communicating layout specifications for automated output Programmer develops stylesheet in text/XML editor. Code specifies page size, font use, and so on. @alanpringle
  • 12. Communicating layout specifications for automated output <xsl:variable name="level-1-family">SansBold</xsl:variable> <xsl:variable name="level-1-size">14pt</xsl:variable> <xsl:variable name="level-1-line-height">15pt</xsl:variable> <xsl:variable name="level-1-weight">normal</xsl:variable> <xsl:variable name="level-1-style">normal</xsl:variable> <xsl:variable name="level-1-indent">0pt</xsl:variable> <xsl:variable name="level-1-color">#000000</xsl:variable> <xsl:variable name="level-1-space-before">42pt</xsl:variable> <xsl:variable name="level-1-space-after">4pt</xsl:variable> @alanpringle
  • 13. Communicating layout specifications for automated output Any changes? “Change the heading color to our new corporate blue.” “Make the chapter heading a little bigger.” Programmer gets specifications from template. @alanpringle
  • 14. Communicating layout specifications for automated output Developed process that relies on... stylesheets! Programmer added detailed code comments. Programmatic formatting requires specific numbers. How do you collect them? @alanpringle
  • 15. Communicating layout specifications for automated output Sample code comment for page size: Physical page dimensions. US Letter is 8.5 in x 11 in; A4 is 8.3 in × 11.7 in. Dimensions that accommodate both paper sizes are 8.3 in x 11.0 in. @alanpringle
  • 16. Communicating layout specifications for automated output Extract code comments and create Word file: @alanpringle
  • 17. Communicating layout specifications for automated output Designer fills out settings and returns file. Programmer gets specific measurements. Code comments serve as reference for later maintenance. @alanpringle
  • 18. Flexibility in layout as a business requirement Flickr: Creative-Tools.com @alanpringle
  • 19. Flexibility in layout as a business requirement Automated PDF formatting is not for all information types. Highly designed study guides required greater flexibility in layout. How do you preserve high-quality layouts for print? @alanpringle
  • 20. Flexibility in layout as a business requirement Transform source XML into InDesign- compatible XML. XML refers to styles in the InDesign template. @alanpringle
  • 21. Flexibility in layout as a business requirement <ParagraphStyleRange AppliedParagraphStyle="ParagraphStyle/body"> <CharacterStyleRange AppliedCharacterStyle="CharacterStyle/ $ID/[No character style]"> <Content>When developing a test bed, it is important to ensure that you cover </Content> </CharacterStyleRange> <CharacterStyleRange AppliedCharacterStyle="CharacterStyle/bold"> <Content>all </Content> </CharacterStyleRange> <CharacterStyleRange AppliedCharacterStyle="CharacterStyle/ $ID/[No character style]"> <Content>basic cases for your requirements.</Content> </CharacterStyleRange> ... </ParagraphStyleRange> InDesign Markup Language (IDML) sample: @alanpringle
  • 22. Flexibility in layout as a business requirement Place XML file into InDesign template. Styles and other formatting applied automatically: @alanpringle
  • 23. Flexibility in layout as a business requirement @alanpringle Wikipedia: Guma89
  • 24. Flexibility in layout as a business requirement Adjust line breaks, pagination, image placement, and so on. Reduced production time significantly. Get benefits of structured content (reuse, in particular). @alanpringle
  • 25. Considering the true costs of customized structures Flickr: Japanexperterna.se @alanpringle
  • 26. Considering the true costs of customized structures Standardization versus creativity is not just about layout. Create custom structure? Adopt standard? When should you change a standard's default structures? @alanpringle
  • 27. Considering the true costs of customized structures Implement XML for conditional content, mobile delivery, and localization. Installation guides: procedures with more than 100 steps. Steps could contain substeps and sub-substeps. @alanpringle
  • 28. Considering the true costs of customized structures Procedure layers: 63. This is the 63rd step in a procedure. a. This is a substep. i. This is a sub-substep. @alanpringle
  • 29. Considering the true costs of customized structures Content model did not support sub-substeps by default. Content creators requested addition of sub-substep element. @alanpringle
  • 30. Considering the true costs of customized structures My reaction to a 100-step procedure with three layers of steps: a. Time to re-evaluate b. Excellent tech comm c. Absolutely not d. CENSORED @alanpringle
  • 31. Considering the true costs of customized structures Information architects: reconsider the long procedures and sub-substeps. Level of effort: modifying versus maintaining default structure. @alanpringle Please.
  • 32. Considering the true costs of customized structures Modify:  Develop and test modification  Implement in authoring tools, CCMS, and stylesheets  Distribute to localization vendors  Train writers on custom structure @alanpringle
  • 33. Considering the true costs of customized structures Maintain:  Rethink procedures to eliminate sub-substeps.  Rewrite to break up lengthy procedures. @alanpringle
  • 34. Considering the true costs of customized structures Content creators: Did not want to rewrite content. Adding sub-substep path of least resistance. Rewriting = admitting that process is bad. @alanpringle
  • 35. Considering the true costs of customized structures Information architects: Rewriting: short-term effort, long-term benefits. Rewrote some content to show increased reuse. What about reading on phones and tablets? @alanpringle
  • 36. Considering the true costs of customized structures @alanpringle
  • 37. Considering the true costs of customized structures No agreement on approach. Company planned to re-evaluate later. Not every consulting engagement has a happy ending. @alanpringle
  • 38. Conclusions Streamline communication with technology. Evaluate costs and biases while considering structural changes. Get benefits of structure and flexible formatting. @alanpringle
  • 39. Conclusions Technical ≠ not creative Need versus want @alanpringle
  • 40. Resources PDF specifications (Word file) tiny.cc/PDFsettings Managing change (Content Strategy 101) tiny.cc/manage-change InDesign XML InDesign & DITA post: tiny.cc/indesign-dita IDML specifications (PDF): tiny.cc/idml @alanpringle