Monday, April 02, 2018

DocBook Schema Version 5.0 Errata 01 approved

OASIS is pleased to announce that The DocBook Schema Version 5.0 Errata 01 from the OASIS DocBook TC [1] has been approved as an OASIS Approved Errata.

The Errata updates the Schematron syntax that had caused the DocBook 5.0 RelaxNG schema to fail to parse properly with updated Schematron validators.

The prose specifications and related files are available here:

The DocBook Schema Version 5.0 Errata 01
OASIS Approved Errata
29 March 2018

Editable source (Authoritative):

HTML: 

PDF: 

Distribution ZIP file

For your convenience, OASIS provides a complete package of the prose specification and related files in a ZIP distribution file. You can download the ZIP file here:


Members of the DocBook TC [1] approved this specification by Full Majority Vote. The specification had been released for public review as required by the TC Process [2]. The vote to approve as a Committee Specification passed [3], and the document is now available online in the OASIS Library as referenced above.

Our congratulations to the TC on achieving this milestone and our thanks to the reviewers who provided feedback on the specification drafts to help improve the quality of the work.

Friday, June 23, 2017

DocBook v5.1 nominated for Outstanding Approved Standard award

Nice to get a nomination in the fourth annual Open Standards Cup!


This year's Outstanding Approved Standard award nominees were DocBook v5.1 from the DocBook TC, KMIP Specification and KMIP Profiles v1.3 from the OASIS Key Management Interoperability Protocol (KMIP) TC, Business Document Naming and Design Rules v1.0 from the OASIS Universal Business Language (UBL) TC, and XLIFF Version 2.0 from the OASIS XML Localisation Interchange File Format (XLIFF) TC.


Congrats to the TOSCA TC on winning the award.


https://www.oasis-open.org/open-standards-cup

Tuesday, April 18, 2017

Scaling quality using Schematron

Do you have limited editorial staff or resources? How do you ensure content quality in spite of an ever-expanding set of content and the unrelenting pressure to deliver that content quickly? In this presentation, we’ll get you started using Schematron to scale your quality control initiatives! When integrated with an XML editor, Schematron provides real-time analysis and feedback to authors to ensure that content follows defined editorial rules. (Remember, we rely on DITA to establish and control structure, but DITA is silent regarding the overall linguistic quality of content.)

You will learn about the process of converting editorial style guide rules to Schematron, including what makes a good Schematron rule. We will provide tips and best practices based on how we implemented Schematron at Jeppesen. You’ll learn which editorial challenges lend themselves to Schematron solutions and which are too linguistically complex and require a human editor.


I'll be presenting on this topic at the CMS / DITA North America conference in San Diego, April 24-26, 2017. Please plan to attend!

URL: https://cm-strategies.com/2017-cms-conference/agenda-day-3-2/hudson-schultz/

Monday, January 16, 2017

Seattle/Kirkland-area DITA listening session on Jan 24/25

In addition to the downtown Seattle DITA listening session on Jan 24, we've added an additional listening session in Kirkland on Jan 25.
RSVP:
When:
  • Wednesday, January 25, 2017
  • 03:30-06:00 PM
Where:
Who:
  • Members of the OASIS DITA Adoption Technical Committee (local and video remote).
  • Area DITA writers, architects, managers, and tool smiths.
  • Company reps at all stages of a DITA implementation.
Goals:
  • Although members of these Technical Committees interact with DITA prospects and DITA practitioners routinely at conferences and online, we suspect that our picture of how things are actually going for DITA companies is incomplete if we do not have venues for those DITA users and architects who have not had opportunity to attend conferences, local user groups (if they exist), or technical forums. These listening sessions are a form of outreach to DITA people where they live and work. They are an opportunity for the Committee to feedback from current, past and future DITA users.
    The Technical Committee recently released DITA Version 1.3 and is now assessing what sorts of features and/or capabilities might be important for DITA 2.0. See http://docs.oasis-open.org/dita/dita/v1.3/ The DITA Adoption Technical Committee focuses on identifying and removing obstacles to initial DITA adoption and long-term DITA investments. See https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita-adoption
What:
  • The format is informal within the following structure:
    • 30 minutes meet n' greet
    • 60 minutes attendee roundtable -- how is DITA doing at your company?
    • 30 minutes Q&A - OASIS TC members asking attendees
    • 30 minutes Q&A - local attendees asking OASIS TC members
    • (Optional) Dinner and refreshments at a local watering hole
RSVP:

Tuesday, January 03, 2017

Favorite Quote of the New Year

My favorite quote of the new year comes from the OASIS members newsletter:
However, the magnitude of your 2016 achievements cannot be denied, so we must begin with a brief look back. Here are just a few of last year's highlights:
- The indefatigable DocBook broke the record for the most downloaded spec in OASIS history. Barring cat videos and Adele's latest songs, DocBook 5.1 is one of the healthiest downloads on the Internet.

Tuesday, December 20, 2016

Seattle-area DITA listening session on Jan 24, 2017

Are you interested in DITA want to provide feedback to the DITA community that might have an impact on its future? The OASIS DITA Adoption Technical Committee is extending an invitation to STC members and participants to attend a Seattle-area “DITA listening session” on Tuesday, January 24, 2017, 3:30-6:00 PM.

Where:

Xeditor (inside the Galvanize Building)
111 S. Jackson St.
Seattle, WA 98104

Although members of these Technical Committees interact with DITA prospects and DITA practitioners routinely at conferences and online, we suspect that our picture of how things are actually going for DITA companies is incomplete if we do not have venues for those DITA users and architects who have not had opportunity to attend conferences, local user groups (if they exist), or technical forums. These listening sessions are a form of outreach to DITA people where they live and work. The sessions are an opportunity for the Committee to obtain feedback from current, past and future DITA users. The Technical Committee recently released DITA Version 1.3 and is now assessing what sorts of features and/or capabilities might be important for DITA 2.0. See http://docs.oasis-open.org/dita/dita/v1.3/

Session Structures:

30 minute – meet n’ greet and then a 60 minute – attendee roundtable—how is DITA doing at your company?
30 minute – Q&A – OASIS TC members asking attendees
30 minute – Q&A – local attendees asking OASIS TC members
(Optional) Dinner and refreshments at a local watering hole (no host)


On site event but no registration required! Please RSVP by January 20th to:

Anthony Apodaca, Business Development
212 884 9402
a.apodaca@xeditor.com | http://www.xeditor.com 

I'd also like to find someone to host a Redmond/Kirkland/Bellvue-area session on Jan 25. Please let me know if your company would be willing to host!

Wednesday, November 23, 2016

DocBook v5.1 is now an official OASIS Standard!

OASIS is pleased to announce that DocBook Version 5.1. has been approved by the membership as an OASIS Standard [1].

The call to vote was made on 09 November 2016 [2] and the ballot closed on 22 November 2016. A minimum of 42 affirmative votes was needed in order to win approval. The finally vote tally was 63 affirmative votes with 4 abstentions. 

Our congratulations to the members of the TC and to the community of implementers, developers and users who have brought the work successfully to this milestone

DocBook is a general purpose [XML] schema particularly well suited to books and papers about computer hardware and software (though it is by no means limited to these applications).

The Version 5.1 release introduces assemblies for topic-oriented authoring. It also addresses a selection of bugs and feature requests.

The Technical Committee provides the DocBook 5.1 schema in other schema languages, including W3C XML Schema and an XML DTD, but the RELAX NG Schema is the normative schema.

URIs:

The prose specifications and related files are available here:

DocBook Version 5.1

HTML (Authoritative): 

PDF: 

Editable source:

Schemas: 

DocBook V4.x conversion tools: 

Distribution ZIP files

For your convenience, OASIS provides a complete package of the prose specification and related files in a ZIP distribution file. You can download the ZIP file here:



Wednesday, November 09, 2016

Voting opens for DocBook v5.1 as an OASIS Standard

The ballot to approve DocBook v5.1 as an OASIS standard is now open, starting at 09 November 2016 at 00:00 UTC. The ballot closes at 22 November 2016 at 11:59 UTC. 


This is a call to the primary or alternate representatives of OASIS Organizational Members to vote. 

If your company is a member of OASIS, please encourage your representative to vote in favor of this standard at: https://www.oasis-open.org/committees/ballot.php?id=3010 


The Version 5.1 release introduces assemblies for topic-oriented authoring. It also addresses a selection of bugs and feature requests.

To view the specification, please see:

Thursday, August 04, 2016

Media Standards for XML

Please excuse the vanity post, but I'm proud to be a contributing author to The Language of Technical Communication! My article is entitled, "Media Standards for XML" on pg 78. Lots of great information in this book compiled by Ray Gallon. Check it out!

Tuesday, June 14, 2016

A Geek Force for Good

I want to give a shout out to the Information Technology Disaster Resource Center (ITDRC), which helps communities with their technology infrastructure after a disaster.


I found out about the group during the 2013 floods in Colorado, where we specifically deployed to Lyons, Jamestown and Boulder.



The ITDRC has Field Disaster Response Teams (FDRT) and Remote Response Teams (RRT) from all across the United States and are comprised of service oriented IT and AV Professionals from many technology disciplines who volunteer their expertise and skills in times of disaster. We use our tech skills to help communities and small businesses continue operations and successfully recover from disaster.

If you have any technical expertise (especially with wifi, networking, radio communications), we would love to get you on board! Visit http://itdrc.org/volunteer.html for more info. We also love equipment and financial donations. See if your company would be willing to help us help those in need!

This past weekend, we held an Operations Field Exercise in Richardson, Texas. It was a great time to connect with other tech geeks and learn about our deployment kits and mobile command centers.






Monday, February 01, 2016

DITA 1.3 is now an official OASIS Standard

I'm pleased to announce DITA 1.3 is now an official OASIS standard!


From the press release:
 "The OASIS open standards consortium today announced that its members have approved the Darwin Information Typing Architecture (DITA) version 1.3 as an OASIS Standard, a status that signifies the highest level of ratification. DITA defines an XML architecture for designing, writing, and publishing information in numerous formats, including print, Web-based, mobile, and electronic publications. DITA is widely used for professionally-published books and magazines, technical documentation, online help, training and course development, marketing materials, and medical information because of its modular, topic-based approach and its ability to support content reuse.
This release of DITA comes in three parts, optimized for different audiences:
  • Base Edition is designed for application developers and users who need only the most fundamental pieces of the DITA framework.
  • Technical Content Edition includes specializations usually used by technical communicators.
  • All Inclusive Edition is designed for implementers who want all OASIS-approved specializations, as well as users who develop learning and training materials."
 For the spec or to download the schemas, go to: http://docs.oasis-open.org/dita/dita/v1.3/os/

The latest version of the DITA Open Toolkit also has support for v1.3, and can be downloaded here:
http://www.dita-ot.org/download

Several XML Editors have also added support for DITA v1.3, including:
  • oXygen XML Editor
  • XMetaL

Monday, May 11, 2015

Optimizing the DITA Authoring Experience

I'll be giving a webinar tomorrow through the DCL Learning Series on "Optimizing the DITA Authoring Experience". There is still time to register: http://buff.ly/1J5iruk

Thursday, May 07, 2015

Schema TRON

One of the members of our DITA Boot Camp this week kept referring to Schematron in an ominous voice because it looks at your actual writing content (as opposed to DTD or RNG that validates the structure). It became a bit of a joke, so I was inspired to create the following wallpaper. Since Tron is part of the name "Schematron", I used the Tron Legacy theme! And now for your enjoyment...


Friday, May 01, 2015

Highlights from the CMS/DITA NA 2015 Conference

The Content Management Strategies/DITA North America 2015 conference was held April 20-22 in Chicago, Illinois. Over 350 attendees learned best practices in four tracks: Information Design & Development, Technical Solutions, Management, and Emerging Technologies.

As a member of the CIDM staff, I was fortunate to host the Emerging Technologies track and got a chance to learn about a few new technologies, myself! If you missed it, I tried to Live Tweet the key points from each of the sessions here: #cmsconference #emergingtechnologies

Several "game changer" presentations included:
So what was game changing?

The guys at oXygenXML have developed a series of pipeline transforms (Project DITA Glass) that let you, for example, use a topicref (with a special url) to an Excel spreadsheet directly. That URL is transformed on-the-fly directly to DITA, which can then be rendered directly in a table as part of your document! It also can round-trip, so any changes made in the DITA are written back into the Excel sheet.

This is important for those times when you need information from a subject matter expert, but don't want to teach them DITA or have to manually convert their content so you can use it. It's a one-stop shop! They are working on many more transforms. My hope is that they will create one for PowerPoint to DITA for all of the Learning and Training folks out there. Most course developers still work in PowerPoint, but it would be much more powerful to use the DITA publishing tool chains for various outputs while letting the developers still create in their familiar tool.

Another one-stop shop technology is the Dynamic Information Model. Comtech and oXygenXML have partnered together to create an XML-based Information Model, where a company can document their editorial and content structures, while also enabling the automatic enforcement and expression of that Model in the authoring environment! It basically generates the schematron rules and tool tips for authors from the Information Model itself. Very powerful!

A consistent theme in emerging technologies and technical solutions was the dynamic rendering of DITA content (server-side and client-side). There were several approaches presented, but they basically eliminate the DITA-OT publishing step by using CSS+XSL to render DITA content directly or on-demand.

Another particularly interesting theme was presenting technical information in an Augmented Reality environment. In fact, there is a new technical committee being formed at OASIS to address this very subject area! There are some tools available today for creating AR, including DAQRI 4d Studio, Metaio creator and SDK, Wikitude SDK, nGrain. The benefits of this technology include: reduce quality errors, contextual instructions at point of use, remote expert support, increased productivity. AR statistically has been proven to improve first time quality on assembly tasks, with fewer errors. AR can provide procedural steps, along with an overlay of task location, assembly info and more to assist in the completion of a task.

Did you know that by 2020, 103 million cars will be AR-enabled? Are you aware of AR devices, such as Google Glass, Microsoft Hololens, and DAQRI? Now is the time to start preparing your technical content for use with these types of devices. The future is so bright, we need to wear AR shades!

Thursday, April 09, 2015

Talisman: Rome now available on Talisman Island

Several years ago, my friend Cameron Crawford and I developed a fan expansion for the board game, Talisman (2nd Edition) from Games Workshop.

I am a huge fan of ancient Rome and the Roman Army. Cam is a huge fan of Greek and Roman mythology. We decided to combine our interests and our love of the Talisman board game to create Talisman: Rome. Most of the artwork is lovingly borrowed, so we cannot sell our creation nor can others sell it.

Thanks to some templates provided by Jon New of Talisman Island, I recently updated Talisman: Rome for Talisman (4th Edition) from Fantasy Flight Games.

Both versions are available for free download from Talisman Island.

I also had the expansion printed by Print and Play Games. The results are terrific!


I hope others with similar interests in board games, Talisman or ancient Rome will appreciate this labor of love!

Friday, March 20, 2015

DocBook Version 5.1 now in Public Review

The OASIS DocBook TC [1] members have recently approved a Committee Specification Draft (CSD) and submitted it for 30-day public review:

DocBook Version 5.1
Committee Specification Draft 01 / Public Review Draft 01
11 Feb 2015

Overview:

DocBook is a general purpose [XML] schema particularly well suited to books and papers about computer hardware and software (though it is by no means limited to these applications). 

The Version 5.1 release introduces assemblies for topic-oriented authoring. It also addresses a selection of bugs and feature requests. 

The Technical Committee provides the DocBook 5.1 schema in other schema languages, including W3C XML Schema and an XML DTD, but the RELAX NG Schema is the normative schema. 

TC Description: 

The DocBook Technical Committee maintains the DocBook family of schemas. 

Public Review Period:

The public review starts 23 March 2015 at 00:00 UTC and ends 21 April 2015 at 23:59 UTC. 

This is an open invitation to comment. OASIS solicits feedback from potential users, developers and others, whether OASIS members or not, for the sake of improving the interoperability and quality of its technical work.

Reviewers may provide comments directly from the comment-tag version of document. The file

docbook-v5.1-csprd01-COMMENT-TAGS.html

contains the HTML version of the draft with a “[comment?]” link next to each section heading. Clicking on this link will launch your email application and begin a message to docbook-comment@lists.oasis-open.org with the specific section number and title in the subject line. Simply enter your comment and click send.

Note that you must be subscribed to the comment mailing list before sending feedback. Instructions on how to subscribe can be found at https://www.oasis-open.org/committees/comments/index.php?wg_abbrev=docbook.

URIs:

The prose specification document and related files are available here:

HTML (Authoritative):

HTML with inline tags for direct commenting:

Editable source: 

PDF: 

RELAX NG Schemas: 

Schematron Schemas:

XML Catalog:

NVDL Schema:

DocBook V4.x conversion tools:

ZIP distribution file (complete):

For your convenience, OASIS provides a complete package of the prose document and related files in a ZIP distribution file. You can download the ZIP file here:


Additional information about the specification and the OASIS DocBook TC can be found at the TC's public home page:


Comments may be submitted to the TC by any person through the use of the OASIS TC Comment Facility which can be used by following the instructions on the TC's "Send A Comment" page, or directly at:


Comments submitted by TC non-members for this work and for other work of this TC are publicly archived and can be viewed at:


All comments submitted to OASIS are subject to the OASIS Feedback License, which ensures that the feedback you provide carries the same obligations at least as the obligations of the TC members. In connection with this public review of "DocBook V5.1", we call your attention to the OASIS IPR Policy [2] applicable especially [3] to the work of this technical committee. All members of the TC should be familiar with this document, which may create obligations regarding the disclosure and availability of a member's patent, copyright, trademark and license rights that read on an approved OASIS specification. 

OASIS invites any persons who know of any such claims to disclose these if they may be essential to the implementation of the above specification, so that notice of them may be posted to the notice page for this TC's work.

========== Additional references:

[1] OASIS DocBook TC



RF on Limited Terms 

Thursday, March 12, 2015

Browser Power plug


Come to the CIDM 2015 CMS/DITA North America conference! I'll be presenting on:

Browser Power: Client-side rendering of DocBook and DITA

What do Chrome, Firefox, Safari, Opera, Vivaldi, and Internet Explorer all have in common? Today’s modern browsers can dynamically render DITA and DocBook. Why use a separate rendering step in the publishing process, when the XML can be delivered directly from the server and rendered in any modern browser, including mobile? In this session, you will learn how to customize the browser presentation layer and some of the caveats for the content.

Join CIDM in Chicago, Illinois, April 20-22, 2015 for the 2015 CMS/DITA North America conference, the premier content management event of the year. Meet with your colleagues and build new friendships and relationships.

At 2015 CMS/DITA North America, you'll find a superb line-up of more than 75 presentations and an Exhibition Hall bursting at the seams with the latest technology and product innovations. Each exhibitor offers technologies that help you create content, manage your content store, produce attractive and effective publications, and ensure the quality of what you deliver to customers. Remember, they are anxious to learn about your needs as well. 

Come for the community, experience new insights, and leave with a wealth of new ideas that help you reap the benefits of managing content in your organization. In its 17th successful year, CMS/DITA North America is the premier conference for everyone who manages technical and business content in both small departments and huge global enterprises.

For more information: http://www.cm-strategies.com

Tuesday, March 10, 2015

Thursday, February 26, 2015

A new chapter

I can't believe my last post was back in 2011! The advent of social media has definitely affected my available blog time. If you need to catch up on my recent activity, check out my FaceBook or Twitter.

They say the best time to leave a job is on your own terms and timing. That is also true in this case. I was contacted by a member of one of my XML standards committees about an opportunity to consult in my area of expertise. I will be providing information design and XML content management consulting with Comtech Services, Inc. I will also continue to be active in the OASIS DITA and OASIS DocBook standards, but sadly, not ONVIF.

My first ONVIF meeting was in Zug, Switzerland at Siemens, and it turns out my last meeting was at Pelco in Fort Collins, Colorado. I touched a lot of areas in ONVIF, including:

I truly consider my time with ONVIF to be one of the major accomplishments of my career.

I also had a lot of successes at Pelco. I managed the Pelco Developer Network (PDN) site, including information architecture, administration and content creation. I optimized the process for creating the Pelco SDK documentation using oXygen XML editor, schematron and DITA. I implemented the WSDL documentation format for the Pelco APIs.


Considering that I was entirely new to the video surveillance industry, I think I made a decent impact over almost 5 years! I was able to bring best practices in XML documentation to Pelco and to the ONVIF standard, and met many unforgettable people and places along the way.