Preface

The Open Group

The Open Group is a global consortium that enables the achievement of business objectives through technology standards. Our diverse membership of more than 800 organizations includes customers, systems and solutions suppliers, tools vendors, integrators, academics, and consultants across multiple industries.

The mission of The Open Group is to drive the creation of Boundaryless Information Flow™ achieved by:

  • Working with customers to capture, understand, and address current and emerging requirements, establish policies, and share best practices

  • Working with suppliers, consortia, and standards bodies to develop consensus and facilitate interoperability, to evolve and integrate specifications and open source technologies

  • Offering a comprehensive set of services to enhance the operational efficiency of consortia

  • Developing and operating the industry’s premier certification service and encouraging procurement of certified products

Further information on The Open Group is available at www.opengroup.org.

The Open Group publishes a wide range of technical documentation, most of which is focused on development of standards and guides, but which also includes white papers, technical studies, certification and testing documentation, and business titles. Full details and a catalog are available at www.opengroup.org/library.

This Guide

This guide is for individuals who are participating in Forums or Work Groups within The Open Group. It includes guidance on the development of The Open Group publications using the AsciiDoc markup language in a GitLab® environment This is suitable for development of standards, guides, and white papers, including standards that are being submitted as ISO/IEC standards. The output can also be configured for camera-ready hardcopy publications.

The audience for this guide is members of The Open Group who want to develop a document using the GitLab platform and the AsciiDoc markup language.

Conventions Used in this Guide

The following conventions are used throughout this document in order to help identify important information and avoid confusion over the intended meaning:

  • Ellipsis (…​)

    Indicates a continuation; such as an incomplete list of example items, or a continuation from preceding text.

  • Bold

    Used to highlight specific terms.

  • Italics

    Used for emphasis. May also refer to other external documents.

In addition to typographical conventions, the following conventions are used to highlight segments of text:

Note

A Note box is used to highlight useful or interesting information.

Tip

A Tip box is used to provide key information that can save you time or that may not be entirely obvious.

About the Authors

Andrew Josey, The Open Group

Andrew Josey is VP Standards and Certification, overseeing all certification and testing programs of The Open Group. He also manages the standards process for The Open Group. Since joining the company in 1996, Andrew has been closely involved with the standards development, certification, and testing activities of The Open Group. He has led many standards development projects including specification and certification development for the ArchiMate®, TOGAF®, POSIX®, and UNIX® programs. Most recently he has led the development of the TOGAF Business Architecture Level 1 certification credential and DPBoK™ Foundation certification. He has led the automation of The Open Group standards development using a GitLab-based automated build toolchain. He is the lead author of this document.

He is a member of the IEEE, USENIX, and the Association of Enterprise Architects (AEA). He holds an MSc in Computer Science from University College London.

David Lounsbury

David is Chief Technical Officer for The Open Group. As CTO he ensures that the people and IT resources at The Open Group are effectively used to implement the organization’s strategy and mission, including The Open Group proven processes for collaboration and certification both within the organization and in support of third-party consortia.

David’s previous executive assignments at The Open Group and the Open Software Foundation (OSF) include VP Advanced Research and Innovation which fostered open systems technology through collaborative funding and development, including LDAP, ActiveX Core Technology, DCE 1.2, CDE-Next, and Complex Text Layout.

David holds a degree in Electrical Engineering from Worcester Polytechnic Institute, and is holder of three US patents.

Anna Adams

Anna is a Technical Editor at The Open Group. Before joining the company full-time in January 2020, Anna worked in the Education sector in the UK, teaching History in a range of settings to include A-Level and SEND.

Anna holds an undergraduate degree in Social Anthropology from Manchester University, a Post Graduate Certificate in Education (PGCE) from Keele University, and an MA in Environment, Policy, and Society from the Open University.