LavaCon 2015 proposal:
Structure and Hypertext
Applying structured writing principles to writing for the
Web using the SPFE architecture.
Presenter: Mark Baker
Format: Lecture/demo
Track: Produce
Traditional Structured Writing
 Focused on books and help systems
 Separate products with hierarchical
structure
 Formal and infrequent publishing cycles
 Complex markup, massive CCMS
requirements
 Linking expensive
 Hard to add and integrate a single page
on the fly
Web publishing
 Focused on pages, sites, and hypertext
 Flat structure; use of search, links
 Constant updates, always current
 Simple unstructured authoring but
content management often cumbersome
 Linking expensive
 Hard to keep track of overall
organization of content
Structured writing for hypertext
 Focused on structure and identity of pages
 Focused on the reliability of content
 Enabling constant update without losing
structure, organization
 Full integration of new content without manual
editing
 Simplified structured authoring, automation of
many content management tasks
 Inexpensive reliable linking
 Bottom-up architecture based on metadata
SPFE
 Open source tool kit for hypertext-oriented
structured writing
 Designed for bottom-up architecture, Every
Page is Page One
 Reduced, simplified markup for ease of
authoring, easy collaboration
 Automated linking and assembly
 CCMS not required. Works well with free VCS
tools.
 Includes support for DITA
In this session,
attendees will learn:
 The difference between structured writing
approaches for books and for hypertext
 How structure can support the immediacy and
connectedness of the Web
 How the open-source SPFE toolkit enables
structured approaches to hypertext Ever Page
is Page One information design
About the presenter
 Mark Baker
 Author, Every Page is Page
One: Topic-based writing for
Technical Communication and
the Web
 Blog: Every Page is Page One
(everypageispageone.com)
 President and Principal
Consultant, Analecta
Communications, Inc.

Structure and hypertext

  • 1.
    LavaCon 2015 proposal: Structureand Hypertext Applying structured writing principles to writing for the Web using the SPFE architecture. Presenter: Mark Baker Format: Lecture/demo Track: Produce
  • 2.
    Traditional Structured Writing Focused on books and help systems  Separate products with hierarchical structure  Formal and infrequent publishing cycles  Complex markup, massive CCMS requirements  Linking expensive  Hard to add and integrate a single page on the fly
  • 3.
    Web publishing  Focusedon pages, sites, and hypertext  Flat structure; use of search, links  Constant updates, always current  Simple unstructured authoring but content management often cumbersome  Linking expensive  Hard to keep track of overall organization of content
  • 4.
    Structured writing forhypertext  Focused on structure and identity of pages  Focused on the reliability of content  Enabling constant update without losing structure, organization  Full integration of new content without manual editing  Simplified structured authoring, automation of many content management tasks  Inexpensive reliable linking  Bottom-up architecture based on metadata
  • 5.
    SPFE  Open sourcetool kit for hypertext-oriented structured writing  Designed for bottom-up architecture, Every Page is Page One  Reduced, simplified markup for ease of authoring, easy collaboration  Automated linking and assembly  CCMS not required. Works well with free VCS tools.  Includes support for DITA
  • 6.
    In this session, attendeeswill learn:  The difference between structured writing approaches for books and for hypertext  How structure can support the immediacy and connectedness of the Web  How the open-source SPFE toolkit enables structured approaches to hypertext Ever Page is Page One information design
  • 7.
    About the presenter Mark Baker  Author, Every Page is Page One: Topic-based writing for Technical Communication and the Web  Blog: Every Page is Page One (everypageispageone.com)  President and Principal Consultant, Analecta Communications, Inc.