The Purpose of This Document Is to Record the Roll Call. the Minutes Are Stored on The

DITA4web Minutes: 1/13/2010

The purpose of this document is to record the Roll Call. The minutes are stored on the SC website as a Video Recording. 2

Teleconference Number 2

Roll Call 3

Join 4

Agenda For Meeting, Wed. Jan 27, 10a.m. 4

Action Items 4

New Minutes 4

Questions 5

Ideas for Papers/Projects 5

Upcoming Events 5

TBD - Michael Beaver: IBM Content Assembler 5

Past Events 6

Don Day: Presents on his DITA Wiki project 6

Seth Park: Discusses DITA for Composite Environments DICE SC Goals 6

Oct 21 – Neil Perlin: Lavacon presentation 6

History 6

Resources 7

DITA For Mobile Devices 7

Presentation by Michael Beaver 7

Reading List 7

iUi Library 8

Social Web 8

“Conversation and Community: The Social Web for Documentation” 8

DITA Wiki 8

Structured Wikis 8

“Using Structured Wikis in Software Engineering” 8

DITA Wiki Presentation 8

DITA 2 Wiki Presentation 9

Growing DITA across the enterprise 9

Wiki slice project 9

Cost Justification – ROI 9

Structures/Formats 10

Microformats 10

Web Services 10

IBM Custom Content Assembler Pilot 10

Usabilty 10

Best Practices 10

Liaisons 11

Other DITA Subcommittees 11

DITA for Composite Environments (DICE) subcommittee 11

DITA Help 11

The purpose of this document is to record the Roll Call. The minutes are stored on the SC website as a Video Recording.

Teleconference Number

866-457-2759, participant code 304588

Roll Call

Mark Lewis [OASIS Member]

John Hunt [OASIS Member]

Mike Hamilton

Michael Beaver

John Allsopp

Lisa Dyer [OASIS Member]

Chris Goolsby [OASIS Member]

Stan Doherty

Don Day

Regrets:

Anne Gentle [OASIS Member]

Tom Voltz

Joan Lasalle

Steve Manning [OASIS Member]

Tony Self

Neil Perlin

Scott Hudson [OASIS Member]

Seth Park [OASIS Member]

Mike Miller

Alan Houser [OASIS Member]

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.

http://www.oasis-open.org/join/

Join the subcommittee.

http://www.oasis-open.org/apps/org/workgroup/dita-web/

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 - JohnH] JohnH ask W3C Xforms SME to talk to us.

New Minutes

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 and HTML 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:
http://publishing2.com/
http://www.publish2.com/
http://www.masternewmedia.org/independent_publishing/usability-for-mobile-phones/usability-guidelines-for-mobile-web-publishing-20071003.htm
http://toc.oreilly.com/resources/mobile.html
http://toc.oreilly.com/resources/
http://mobiforge.com/book/export/html/373
http://newsbreaks.infotoday.com/NewsBreaks/Going-Mobile-Publishing-Technology-Puts-Publishers-in-the-Drivers-Seat-51913.asp
http://mobilewebjunkie.com/coding-for-mobile-web-automatically-adapting-to-every-device-and-browser/#more-531
http://blueflavor.com/blog/2006/jan/16/10-reasons-to-publish-to-mobil/
http://www.scribd.com/doc/12641/Mobile-Web-Developers-Guide
http://crenk.com/publish-your-content-on-your-mobile/?utm_source=feedburner&utm_medium=feed&utm_campaign=Feed%3A+crenk%2Ffeed+%28CRENK%29
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. http://code.google.com/p/iui/

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.

http://www.amazon.com/Conversation-Community-Social-Web-Documentation/dp/0982219113/ref=ntt_at_ep_dpi_1

DITA Wiki

Structured Wikis

http://twiki.org/cgi-bin/view/Codev/StructuredWiki

“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:

http://www.wikis4se.org/lib/exe/fetch.php/2008:wikis4se-2008-using_structured_wikis_in_software_engineering.pdf?id=2008%3Ausing_structured_wikis_in_software_engineering&cache=cache

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:
https://quark.webex.com/quark/ldr.php?AT=pb&SP=MC&rID=15130762&rKey=08088da2428c73ec

Password = dita4web

Background materials:

Worksheet:

http://www.writersua.com/articles/DITA2Wiki/index.html

Presentation:

http://www.slideshare.net/lisa.dyer/lombardi-wikis-model

Growing DITA across the enterprise

Don Day presentation on DITA sourced Wikis

http://dita.xml.org/resource/ibm-dita-wiki-growing-dita-across-the-enterprise

Wiki slice project

“Building a DITA-wiki hybrid” article

By Anne Gentle, Lisa Dyer and Michael Priestley

http://www.stc.org/intercom/PDFs/2008/200804_18-21.pdf

Cost Justification – ROI

Papers at Center for Information-Development and Management

http://www.comtech-serv.com/content_mgmt.shtml

Influencing Change: Negotiating vs. Building a Vision

By Chona Shumate

http://www.infomanagementcenter.com/index.php?page=1387

Papers at the DITA Metrics group on the Content Wrangler Community:

http://thecontentwrangler.ning.com/group/ditametrics/forum/topics/white-paper-dita-metrics-cost

http://thecontentwrangler.ning.com/group/ditametrics/forum/topics/white-paper-dita-metrics

Link to the DITA for Business Documents ROI paper when it becomes available.

Structures/Formats

Microformats

www.Microformats.org

http://24ways.org/2006/styling-hcards-with-css

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 - https://info2.lotus.com/mapalicious.
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

http://www.amazon.com/Letting-Go-Words-Interactive-Technologies/dp/0123694868/ref=sr_1_1?ie=UTF8&s=books&qid=1252494125&sr=1-1

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:

http://www.oasis-open.org/apps/group_public/download.php/34322/DiCE-charter.rtf

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 (http://wiki.oasis-open.org/dita/DITA_1.3_Proposals) 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