Category Archives: S1000D Business Rules

Contributing to Mekon’s Bitesize on Business Rules, June 2018: brDoc: The Attributes You Shouldn’t Ignore

I have written recently a new article for Mekon’s Bitesize series on S1000D business rules. It addresses two XML attributes, the use of which can change Business Rules production process from slow and tedious to efficient, and maintenance costs of technical publications from high to reasonable. These attributes are the business rule Decision Point Priority (brDecisionPointPriority), and business rules Severity Level (brSeverityLevel). Both attributes are present in the new business rules Document (brDoc) Schema introduced in the S1000D Issue 4.2, whereas the latter (brSeverityLevel) has been also added to the well-known BREX Schema. To find out more about these attributes click on the title of the article “brDoc: The Attributes You Shouldn’t Ignore” or here.

(Credits: Photograph ©canva.com with the keyword characteristic)

To learn more about business rules in general and about S1000D business rules in particular, and to keep them under control, check out the following books:

    

and resources:

A Summer Read for S1000D Lovers

If you implement S1000D, then you also work with S1000D business rules. You either have to create them or follow them, or both.

The S1000D specification is several thousand pages long, has several tenths of XML Schema and as many objects to support its use in any of the download packages at www.s1000d.org.

And if you try to address the Business Rules Decision Points (BRDP) and define your project’s or organization’s business rules you will see that you will have to address 427 in S1000D Issue 4.2, 552 in Issue 4.1 and over 700 in Issue 4.0.1.

That sounds pretty overwhelming, doesn’t it?

Susanne Berg from Mekon Ltd suggested about two years ago that I write short articles for their blog category called “Bitesize Business Rules.” I agreed and discovered that writing in little bits about business rules, did make the topic less overwhelming and more understandable. With Mekon’s permission, I have gathered all the articles published there, revised, and had them professionally edited. And today, I have published a little book with the title brDoc, BREX, and Co.: S1000D Business Rules Made Easier.

Based on the feedback to the articles of the “Bitesize Business Rules” series, the bite-sized articles on business rules can help you to “taste” and “digest” one aspect of S1000D business rules (and to some extent also implementation) at a time.

I hoped to make the book available before the S1000D User Forum that will take place in New Orleans this year on September 10-13.

And first I thought the title of this post could be a good joke, but now I think such a book could be “digested” even better when you read it in an atmosphere a bit remote from the actual work. While at it, you could get a new perspective on the complex and multi-dimensional topic of S1000D business rules.

If you read this far, then I invite you to check out the description of this little book here.

Contributing to Mekon’s Bitesize on Business Rules, Jan 2018: brDoc Schema: What is Business Rule Audit (brAudit) about?

Apart from business rules decision points and decisions which are to be taken, you need also to record whether the decision is finalized, or whether there are open actions in their respect. You also have to define the deadlines and the responsibility for those actions.

All that and some other information is recorded in the brAudit element of the new brDoc Schema, defined in Issue 4.2.

In the past month’s contribution to the Mekon’s BR Bitesize series, I addressed this element and the concepts behind it in the article “brDoc Schema: What is Business Rule Audit (brAudit) about?” Click on the title of the article or here to find out more.

(Credits: Photograph ©canva.com with the keyword audit)

Contributing to Mekon’s Bitesize on Business Rules – 14: brDoc Schema: What does brRelatedTo stand for?

At least 90% of the brDoc (business rules document) Schema introduced in S1000D Issue 4.2 is based on the well-known descriptive Schema.

The new 10% which comprise the business rules paragraph (brPara) element and its components are mostly self-explanatory. But some elements might need additional explanation to be understood because their names cannot fit all dimensions of what they mean now and might mean in the future when further developed.

That applies to the element brRelatedTo, which is defined as business rule decision point relationship in Issue 4.2.

In the past month’s contribution to the Mekon’s BR Bitesize series, I addressed this element and the concepts behind it in the article “brDoc Schema: What does brRelatedTo stand for?” Click on the title of the article or here to find out more.

(Credits: Photograph ©canva.com with the keywords business relationship)