DITA4web Minutes: 12/16/2009
Teleconference Number
Roll Call
Join
Agenda For Meeting, Wed. Jan 27, 10a.m.
Action Items
New Minutes
Questions
Ideas for Papers/Projects
Upcoming Events
TBD - Michael Beaver: IBM Content Assembler
Past Events
Don Day: Presents on his DITA Wiki project
Seth Park: Discusses DITA for Composite Environments DICE SC Goals
Oct 21 – Neil Perlin: Lavacon presentation
History
Resources
DITA For Mobile Devices
Presentation by Michael Beaver
Reading List
iUi Library
Social Web
“Conversation and Community: The Social Web for Documentation”
DITA Wiki
Structured Wikis
“Using Structured Wikis in Software Engineering”
DITA Wiki Presentation
DITA 2 Wiki Presentation
Growing DITA across the enterprise
Wiki slice project
Cost Justification – ROI
Structures/Formats
Microformats
Web Services
IBM Custom Content Assembler Pilot
Usabilty
Best Practices
Liaisons
Other DITA Subcommittees
DITA for Composite Environments (DICE) subcommittee
DITA Help
Teleconference Number
866-457-2759, participant code 304588
Roll Call
Mark Lewis [OASIS Member]
Anne Gentle [OASIS Member]
John Hunt [OASIS Member]
Tom Voltz
Joan Lasalle
Steve Manning [OASIS Member]
Tony Self
Chris Goolsby [OASIS Member]
Regrets:
Neil Perlin
Scott Hudson [OASIS Member]
Seth Park [OASIS Member]
Lisa Dyer [OASIS Member]
Mike Miller
Alan Houser [OASIS Member]
Stan Doherty
Mike Hamilton
Pamela Kostur
Join
To participate in the DITA for the Web subcommittee, you need to be a member of OASIS and a member of the subcommittee.
Join OASIS.
Join the subcommittee.
Agenda For Meeting, Wed. Jan 27, 10a.m.
Michael Priestley: presentation on DITA Semantic Ecosystem
Discussion Point: “Corporate vs. End-User Content” continues (time permitting)
Action Items
[Action Item - Neil] Neil will review and give his thoughts on the Help SC Best practices paper in a meeting or two.
[ Action Item – ScottH] Find links on mobile publishing.
[Action Item - JohnH] JohnH ask W3C Xforms SME to talk to us.
[Action Item - MarkL] tell Seth when our web page is ready and Seth will summarize the goals of DICE on one of those pages.
[Action Item - Mark] Ask Don Day when he could present his DITA Wiki project and differentiate it from Lisa Dyer’s project. This definitely seems to be an area of interest. Unsolicited, Tom Johnson started talking to me about wanting to display content in a wiki, but also single source and translate.
[Action Item - John] John ask Michael Beaver if he can present at Dec 16, or Jan 6 meeting.
[Action Item - MarkL] Talk to Mary McRae about getting an OASIS webpage and an understanding of what should be published there.
New Minutes
Don Day Chief Arch for Lightweight DITA Publishing
Targeting SME's that are putting content into files that are hard to discover and hard to reuse
Initial presentation of a DITA wiki concept by Paul Prescod, presentation 2005, Structured Authoring in Wikis: The Convergence of Structure and Chaos.
[MarkL] I am trying to find a valid link to this article. The posting at IDEA Alliance is no more.
Eric Armstrong, top consultant, is seeking employment, btw.
Slide view
Slides are being dynamically rendered on the fly.
PHP server framework
Common core services...FileNet based
Enterprise Wikis
Don did an assessment of the current technologies.
Wiki: DITA at a distance.
XOPUS new web based editor. Integrated with their DITA Wiki.
Don has a dedicated programmer for maintenance.
Basic architecture: PHP app framework, plug-in architecture.
Briefcase mode, view and edit still possible when not plugged into the Cloud.
Views:
Clean - normal reading view
Details - shows hidden markup
Slides
*Other views can be inserted via web service based editor
Group toggle:
Group members login using LDAP tech and have access to allowed groups.
Map toggle:
maps, sort-able: by alpha, by status
Don, could we have an outliner, mindmapping type of web in left pane and then convert that into a map?
DIFF, New tool, currently only shows difference fragments not side-by-side view.
HTML Slidy is an open source Web-based alternative to Microsoft PowerPoint based upon XHTML, CSS and JavaScript, and which runs on a wide variety of browsers.
Slide view can be used to render the entire map as a…
[TomV] Will this be open sourced?
Don: we want to make it open source and go through due process, trying to make that happen.
dynamic information framework
A componentized version of the Wiki that can be used separately, such as the dynamic renderer.
Fork feature: Makes a copy of an existing topic and assigns it a unique ID.
Map editors that are web-based can be easily integrated as long as they can be integrated to the repository.
[Action Item - MarkL] Ask Lisa about what is different between her DITA Wiki project and Don's
Xforms:
[Action Item - JohnH] JohnH ask W3C Xforms SME to talk to us.
Help SC:
DITA Wiki:
[Action Item - Mark]: Ask who wants to be a liaison to another group.
Questions
Who is our search engine / metadata expert?
HelpSC: AirHelp: Were any changes to DITA required to support this? It looks like the AirHelp OT Plugin works.
HelpSC: Context Sensitive Help: Were any changes to DITA required to support this? The ID is stored in the topicref\resourceID attribute.
Ideas for Papers/Projects
DITA for Mobile Devices
DITA sourced Wikis
How DITA already facilitates content being more findable in a Google search. DITA Class attribute.
How to write web ready content. {This may need to be addressed with the Adoption TC}
Publishing DITA andHTML 5
Research on Microformats
Research on RESTful services and other web services
Upcoming Events
TBD - Michael Beaver: IBM Content Assembler
Demo of Content Assembler by Michael Beaver. John will schedule.
John will see if he can get permission to give a presentation on DITA and Microformats.
Past Events
Don Day: Presents on his DITA Wiki project
Seth Park: Discusses DITA for Composite Environments DICE SC Goals
Oct 21 – Neil Perlin: Lavacon presentation
Neil: Will give his Lavacon presentation at the DITA4Web meeting, Oct 21.
History
Resources
DITA For Mobile Devices
Presentation by Michael Beaver
TODO: add URL
Reading List
Links courtesy of Scott Hudson. Thanks Scott.
Following is some recommended reading for DITA for mobile devices:
This reading set is really intended to get us more information on mobile
web and mobile publishing to generate ideas for how we might address
using DITA for mobile devices.
Happy reading!
iUi Library
Developing a mobile interface for DITA content:
We can get a great jumpstart on this with the iUi library for the iPhone.
Social Web
“Conversation and Community: The Social Web for Documentation”
By Anne Gentle
Does your book discuss the concept of warranted versus non-warranted content, corporate versus community generated content?
[Anne] To answer your question, yes, my book includes a section on page 155 about differentiating warranted content as a wiki best practice.
DITA Wiki
Structured Wikis
“Using Structured Wikis in Software Engineering”
By Anne Gentle, Lisa Dyer
[On Warranted Content] You can also download and read a paper that Lisa Dyer and Anne Gentle wrote for WikiSym that describes Lombardi's "fencing" of content:
DITA Wiki Presentation
By Don Day
Don demonstrated their DITA Wiki project.
TODO: add link to recording
DITA 2 Wiki Presentation
By Lisa Dyer
Lisa Dyer to give DITA Wiki presentation. ~20-25 minutes. Links to workbook and full presentation available.
I want to share the following WebEx recording with you. Click the link below to play it:
Password = dita4web
Background materials:
Worksheet:
Presentation:
Growing DITA across the enterprise
Don Day presentation on DITA sourced Wikis
Wiki slice project
“Building a DITA-wiki hybrid” article
By Anne Gentle, Lisa Dyer and Michael Priestley
Cost Justification – ROI
Papers at Center for Information-Development and Management
Influencing Change: Negotiating vs. Building a Vision
By Chona Shumate
Papers at the DITA Metrics group on the Content Wrangler Community:
Link to the DITA for Business Documents ROI paper when it becomes available.
Structures/Formats
Microformats
Web Services
TODO: add link to RESTful
IBM Custom Content Assembler Pilot
The IBM Custom Content Assembler pilot, which uses RESTful APIs and services to support dynamic assembly and delivery of DITA content.
The updated public pilot site just went live -
Have a look and see what you think.
Be sure to try out the Build Custom Document view, where you can search and select sub-sets of the map content to publish to html or pdf.
And there's some information about the REST service behind this and APIs on the About pages.
Usabilty
Letting Go of the Words: Writing Web Content that Works
By Ginny Redish
Best Practices
Links to Minimalism papers
Liaisons
Chris Goolsby: liaison to DITA Help subcommittee
Other DITA Subcommittees
DITA for Composite Environments (DICE) subcommittee
Chair - Seth Park
Charter:
Correspondence with Seth Park
The early work of DITA in Composite Environments has led to two draft proposals for 1.3, so far.
We will continue to capture them in the wiki ( until it is appropriate to begin discussing them.
The primary DiCE objective is to allow DITA content meaningful with other XML data sources, so...
Any web strategy for DITA that means using the XML source directly will have natural overlaps.
Any strategy that deals with web deliverables generated from DITA source will not overlap.
Any strategy that uses or generates RDFa (or other semantic web technology) will overlap philosophically (yet not necessarily technically).
DITA Help
Chair - Tony Self