Showing posts with label techwriting. Show all posts
Showing posts with label techwriting. Show all posts

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:

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 

Monday, April 14, 2008

DocBook vs. DITA: revisited

The Content Wrangler has published a very interesting article by Dick Hamilton on choosing an XML schema.

I get asked very similar questions all the time! I think I'll start sending folks to this article as recommended reading...