The document discusses how DITA (Darwin Information Typing Architecture) can benefit organizations beyond just technical publications departments. It provides examples of how product engineering, marketing, customer support, and training departments could leverage DITA to improve content contribution workflows, review processes, multi-channel publishing of materials, and content localization across languages. Specific benefits highlighted include centralized storage of specifications, collaborative review tools, automated output to different formats, and reduced localization costs from reusable topic-based content.
The Critical Role of the Executive Sponsor in Enterprise Cloud AdoptionKPI Partners
This white paper explores how executive-level project sponsorship is vital in the successful disruption of IT-norms in favor of value-added and highly nimble cloud solutions.
As enterprise-level companies consider cloud strategies aligned to meeting corporate growth and performance objectives, executive sponsors have myriad considerations to undertake. Such considerations may include:
Cloud platform selection
Project portfolio strategy
Implementation, change, and risk tolerance
IT and business team synergies
Create Your Cloud With KPI.
KPI Partners provides the value, velocity, and quality our customers demand when optimizing an investment in the Salesforce.com application suite. From small and mid-market deployments to complex highly integrated enterprise-level initiatives, KPI's team of sales professionals, program managers, architects, developers, and quality assurance staff deliver outstanding results.
Enterprise Architecture for Business Model Innovation in a Connected EconomySergio Compean
This paper describes an approach to perform a mapping from a business model design to an enterprise architecture which is manifested in a platform ecosystem that supports agile innovation. The paper will be of interest to executives and IT leadership seeking strategic insights for unlocking the creative potential of business model innovation. The paper also provides those interested in enterprise architecture, business model design and systems integration with a concrete roadmap and actionable guidance to execute on the vision.
A versatile workshop program that results in strong stakeholder ownership. Modules cover strategic planning, product development, process design, issue resolution, action planning, requirements analysis and quality review.
Multi-day workshop programs involving 12 - 16 participants in a single session with over 100 stakeholders participating across sessions.
The Critical Role of the Executive Sponsor in Enterprise Cloud AdoptionKPI Partners
This white paper explores how executive-level project sponsorship is vital in the successful disruption of IT-norms in favor of value-added and highly nimble cloud solutions.
As enterprise-level companies consider cloud strategies aligned to meeting corporate growth and performance objectives, executive sponsors have myriad considerations to undertake. Such considerations may include:
Cloud platform selection
Project portfolio strategy
Implementation, change, and risk tolerance
IT and business team synergies
Create Your Cloud With KPI.
KPI Partners provides the value, velocity, and quality our customers demand when optimizing an investment in the Salesforce.com application suite. From small and mid-market deployments to complex highly integrated enterprise-level initiatives, KPI's team of sales professionals, program managers, architects, developers, and quality assurance staff deliver outstanding results.
Enterprise Architecture for Business Model Innovation in a Connected EconomySergio Compean
This paper describes an approach to perform a mapping from a business model design to an enterprise architecture which is manifested in a platform ecosystem that supports agile innovation. The paper will be of interest to executives and IT leadership seeking strategic insights for unlocking the creative potential of business model innovation. The paper also provides those interested in enterprise architecture, business model design and systems integration with a concrete roadmap and actionable guidance to execute on the vision.
A versatile workshop program that results in strong stakeholder ownership. Modules cover strategic planning, product development, process design, issue resolution, action planning, requirements analysis and quality review.
Multi-day workshop programs involving 12 - 16 participants in a single session with over 100 stakeholders participating across sessions.
Many who have entered the young profession of IT Architecture have done so through a ?back door.? One can enter by virtue of lots of IT experience, but sooner or later that person will hit the wall as the challenges and expectations of the position set in. Iasa?s structuring of the IT architecture profession--Five Pillars, certifications, and professional development activities--help you see what you?ve been good at, what you?ve been averse to, and what you?ve not accepted as part of the job but really was. For individual practitioners, understanding this is energizing. For companies, having an architecture organization that consists of knowledgeable, energized staff who work under clearly defined roles and responsibilities can be the difference between success and failure. Hear about opportunities for individuals and companies to leverage the wealth of resources Iasa offers and be part of its work to move the profession forward.
Over 40,000 clients around the globe use the Accenture Supply Chain Academy because they want to raise the performance of their supply chain through knowledge & skill development of their employees... Our online learning solution has allowed them to improve efficiency and reduce cost because we cover all the functional areas of the supply chain. I would love to discuss this with you further patricia.b.terra@accenture.com
Proven Strategies to Fuel Your Design TeamSOLIDWORKS
Continuous improvement separates great companies from mediocre ones. Innovative products, efficient manufacturing, and an energized staff are attributes of a company constantly looking at itself and asking, “How can we do this better?”
Presentation for bcs citp assessment interviewmarkvard
A 10 minute presentation referencing IT works I have been personally responsible for. It was presented as part of an assessment interview to become Chartered IT Professional (CITP) Sep 2019.
EA governance is the practice by which enterprise architectures are managed and controlled at an enterprise-wide level. Governance processes should be tailored to the particular environment of the organization, as well as the architectural goals and objectives of that organization, and should never hinder time to market. A centralized governance body can facilitate and drive key functional and architectural decisions across the primary internal stakeholders to ensure that the enterprise architecture addresses customers’ needs.
The presenter has implemented numerous EA governance organizations. As part of a major pharmaceutical distribution company’s corporate-wide SOA adoption program, he adapted the basic governance frameworks such as TOGAF to the organization and the objectives of the SOA adoption program. This session will examine the processes that were used to create an EA Governance organization at a major energy company and lessons learned at this company, as well as at other organizations.
Building An XML Publishing System With DITAScott Abel
Presented at DocTrain East 2007 Conference by Brian Buehling, Dakota Systems -- Since its inception, DITA has rapidly gained acceptance as a standard document structure used in many XML-based content management and publishing systems. DITA is an XML schema developed primarily to support technical documentation for a wide array of applications. This session will cover the commonly used element, attribute and entity constructs that are defined in the schema. More importantly, recommendations concerning how best to implement DITA solutions will be given. Special attention is given to developing practical DITA applications since, in many cases, some DITA elements will have to be extended through a mechanism called specialization to produce a robust XML-based publishing system.
Many who have entered the young profession of IT Architecture have done so through a ?back door.? One can enter by virtue of lots of IT experience, but sooner or later that person will hit the wall as the challenges and expectations of the position set in. Iasa?s structuring of the IT architecture profession--Five Pillars, certifications, and professional development activities--help you see what you?ve been good at, what you?ve been averse to, and what you?ve not accepted as part of the job but really was. For individual practitioners, understanding this is energizing. For companies, having an architecture organization that consists of knowledgeable, energized staff who work under clearly defined roles and responsibilities can be the difference between success and failure. Hear about opportunities for individuals and companies to leverage the wealth of resources Iasa offers and be part of its work to move the profession forward.
Over 40,000 clients around the globe use the Accenture Supply Chain Academy because they want to raise the performance of their supply chain through knowledge & skill development of their employees... Our online learning solution has allowed them to improve efficiency and reduce cost because we cover all the functional areas of the supply chain. I would love to discuss this with you further patricia.b.terra@accenture.com
Proven Strategies to Fuel Your Design TeamSOLIDWORKS
Continuous improvement separates great companies from mediocre ones. Innovative products, efficient manufacturing, and an energized staff are attributes of a company constantly looking at itself and asking, “How can we do this better?”
Presentation for bcs citp assessment interviewmarkvard
A 10 minute presentation referencing IT works I have been personally responsible for. It was presented as part of an assessment interview to become Chartered IT Professional (CITP) Sep 2019.
EA governance is the practice by which enterprise architectures are managed and controlled at an enterprise-wide level. Governance processes should be tailored to the particular environment of the organization, as well as the architectural goals and objectives of that organization, and should never hinder time to market. A centralized governance body can facilitate and drive key functional and architectural decisions across the primary internal stakeholders to ensure that the enterprise architecture addresses customers’ needs.
The presenter has implemented numerous EA governance organizations. As part of a major pharmaceutical distribution company’s corporate-wide SOA adoption program, he adapted the basic governance frameworks such as TOGAF to the organization and the objectives of the SOA adoption program. This session will examine the processes that were used to create an EA Governance organization at a major energy company and lessons learned at this company, as well as at other organizations.
Building An XML Publishing System With DITAScott Abel
Presented at DocTrain East 2007 Conference by Brian Buehling, Dakota Systems -- Since its inception, DITA has rapidly gained acceptance as a standard document structure used in many XML-based content management and publishing systems. DITA is an XML schema developed primarily to support technical documentation for a wide array of applications. This session will cover the commonly used element, attribute and entity constructs that are defined in the schema. More importantly, recommendations concerning how best to implement DITA solutions will be given. Special attention is given to developing practical DITA applications since, in many cases, some DITA elements will have to be extended through a mechanism called specialization to produce a robust XML-based publishing system.
Patterns for Success: Lessons Learned When Adopting Enterprise DevOpsCognizant
Enterprises that have successfully embraced DevOps are realizing real benefits. Not every DevOps story, however, is a successful one. Here's how to ensure DevOps earns a great reputation in your organization.
17 Must-Do's to Create a Product-Centric IT OrganizationCognizant
Tightening IT-business alignment and embracing Agile, DevOps and Lean Startup principles, while transcending traditional project management disciplines by incorporating product engineering rigor, are critical to creating an effective, digitally enhanced business.
Community Platform: Choosing the Right One Satya S
How will you go about selecting the best platform out there in the market? Are you selecting a product that has features which can really be utilized? Do you really require the host of features offered by the social networking tools? Get answers to all these questions and much more.
Structured authoring for business-critical contentJason Aiken
For decades, XML has armed technical documentation professionals with a component-based approach to content that overcomes the many challenges caused by standalone, static documents created in silos. The problem, however, is that there is so much other business-critical content out there that could benefit from a structured approach to authoring for content automation.
Learn why it is critical for technical documentation experts to translate their best practices into solutions that non-technical content creators can apply to business-critical content. Business-critical content is content you sell, content that helps you sell, or content that helps you run your business.
How to Reach Peak Performance With the Product Management Organizational Heal...Aggregage
The degree of maturity of your product management organization can directly drive your ability to satisfy customers and become more profitable. Our Product Management Organizational Health Checklist and on-demand webinar can help.
Prezentacja autorstwa Aleksandra Wyki przedstawiona na I Panelu BizDevOps. Omawia:
- Business Architecture - jak Business Capabilities, Value Streams, Business Model I Operating Model mogą wspomóc wdrażanie koncepcji BizDevOps
- Agile Architecture a koncepcja BizDevOps
Session at tcworld 2016. Organized by Kristen James Eberlein (Eberlein Consulting LLC); other participants were Joe Gollner (Gnostyx), George Bina (SyncroSoft), Jean-François Ameye (IXIASOFT), and Eliot Kimber (Contrext).
apidays London 2023 - DocOps and Automation in Fintech, Kateryna Osadchenko, ...apidays
apidays London 2023 - APIs for Smarter Platforms and Business Processes
September 13 & 14, 2023
DocOps and Automation in Fintech: A tech writer's perspective
Kateryna Osadchenko, Content Designer at Kindred Group PLC
------
Check out our conferences at https://www.apidays.global/
Do you want to sponsor or talk at one of our conferences?
https://apidays.typeform.com/to/ILJeAaV8
Learn more on APIscene, the global media made by the community for the community:
https://www.apiscene.io
Explore the API ecosystem with the API Landscape:
https://apilandscape.apiscene.io/
LavaCon 2017 - Building an Enterprisewide Content Platform—and Why DITA will ...Jack Molisani
Breaking down content silos requires an enterprise-wide strategy that serves a number of distinct departments, creators, reviewers, and consumers. However, an enterprise-wide strategy that requires an enterprise-wide deployment of DITA will very likely fail. DITA simply is not made for ALL the content types and workflows within an organization, which usually span support, marketing, product documentation, legal, and more. In this session, we’ll focus on why an enterprise-wide content strategy is important, alternatives to DITA, and how to get started.
Removing Uninteresting Bytes in Software FuzzingAftab Hussain
Imagine a world where software fuzzing, the process of mutating bytes in test seeds to uncover hidden and erroneous program behaviors, becomes faster and more effective. A lot depends on the initial seeds, which can significantly dictate the trajectory of a fuzzing campaign, particularly in terms of how long it takes to uncover interesting behaviour in your code. We introduce DIAR, a technique designed to speedup fuzzing campaigns by pinpointing and eliminating those uninteresting bytes in the seeds. Picture this: instead of wasting valuable resources on meaningless mutations in large, bloated seeds, DIAR removes the unnecessary bytes, streamlining the entire process.
In this work, we equipped AFL, a popular fuzzer, with DIAR and examined two critical Linux libraries -- Libxml's xmllint, a tool for parsing xml documents, and Binutil's readelf, an essential debugging and security analysis command-line tool used to display detailed information about ELF (Executable and Linkable Format). Our preliminary results show that AFL+DIAR does not only discover new paths more quickly but also achieves higher coverage overall. This work thus showcases how starting with lean and optimized seeds can lead to faster, more comprehensive fuzzing campaigns -- and DIAR helps you find such seeds.
- These are slides of the talk given at IEEE International Conference on Software Testing Verification and Validation Workshop, ICSTW 2022.
The Art of the Pitch: WordPress Relationships and SalesLaura Byrne
Clients don’t know what they don’t know. What web solutions are right for them? How does WordPress come into the picture? How do you make sure you understand scope and timeline? What do you do if sometime changes?
All these questions and more will be explored as we talk about matching clients’ needs with what your agency offers without pulling teeth or pulling your hair out. Practical tips, and strategies for successful relationship building that leads to closing the deal.
Securing your Kubernetes cluster_ a step-by-step guide to success !KatiaHIMEUR1
Today, after several years of existence, an extremely active community and an ultra-dynamic ecosystem, Kubernetes has established itself as the de facto standard in container orchestration. Thanks to a wide range of managed services, it has never been so easy to set up a ready-to-use Kubernetes cluster.
However, this ease of use means that the subject of security in Kubernetes is often left for later, or even neglected. This exposes companies to significant risks.
In this talk, I'll show you step-by-step how to secure your Kubernetes cluster for greater peace of mind and reliability.
GraphSummit Singapore | The Art of the Possible with Graph - Q2 2024Neo4j
Neha Bajwa, Vice President of Product Marketing, Neo4j
Join us as we explore breakthrough innovations enabled by interconnected data and AI. Discover firsthand how organizations use relationships in data to uncover contextual insights and solve our most pressing challenges – from optimizing supply chains, detecting fraud, and improving customer experiences to accelerating drug discoveries.
GDG Cloud Southlake #33: Boule & Rebala: Effective AppSec in SDLC using Deplo...James Anderson
Effective Application Security in Software Delivery lifecycle using Deployment Firewall and DBOM
The modern software delivery process (or the CI/CD process) includes many tools, distributed teams, open-source code, and cloud platforms. Constant focus on speed to release software to market, along with the traditional slow and manual security checks has caused gaps in continuous security as an important piece in the software supply chain. Today organizations feel more susceptible to external and internal cyber threats due to the vast attack surface in their applications supply chain and the lack of end-to-end governance and risk management.
The software team must secure its software delivery process to avoid vulnerability and security breaches. This needs to be achieved with existing tool chains and without extensive rework of the delivery processes. This talk will present strategies and techniques for providing visibility into the true risk of the existing vulnerabilities, preventing the introduction of security issues in the software, resolving vulnerabilities in production environments quickly, and capturing the deployment bill of materials (DBOM).
Speakers:
Bob Boule
Robert Boule is a technology enthusiast with PASSION for technology and making things work along with a knack for helping others understand how things work. He comes with around 20 years of solution engineering experience in application security, software continuous delivery, and SaaS platforms. He is known for his dynamic presentations in CI/CD and application security integrated in software delivery lifecycle.
Gopinath Rebala
Gopinath Rebala is the CTO of OpsMx, where he has overall responsibility for the machine learning and data processing architectures for Secure Software Delivery. Gopi also has a strong connection with our customers, leading design and architecture for strategic implementations. Gopi is a frequent speaker and well-known leader in continuous delivery and integrating security into software delivery.
How to Get CNIC Information System with Paksim Ga.pptxdanishmna97
Pakdata Cf is a groundbreaking system designed to streamline and facilitate access to CNIC information. This innovative platform leverages advanced technology to provide users with efficient and secure access to their CNIC details.
GraphSummit Singapore | The Future of Agility: Supercharging Digital Transfor...Neo4j
Leonard Jayamohan, Partner & Generative AI Lead, Deloitte
This keynote will reveal how Deloitte leverages Neo4j’s graph power for groundbreaking digital twin solutions, achieving a staggering 100x performance boost. Discover the essential role knowledge graphs play in successful generative AI implementations. Plus, get an exclusive look at an innovative Neo4j + Generative AI solution Deloitte is developing in-house.
Essentials of Automations: The Art of Triggers and Actions in FMESafe Software
In this second installment of our Essentials of Automations webinar series, we’ll explore the landscape of triggers and actions, guiding you through the nuances of authoring and adapting workspaces for seamless automations. Gain an understanding of the full spectrum of triggers and actions available in FME, empowering you to enhance your workspaces for efficient automation.
We’ll kick things off by showcasing the most commonly used event-based triggers, introducing you to various automation workflows like manual triggers, schedules, directory watchers, and more. Plus, see how these elements play out in real scenarios.
Whether you’re tweaking your current setup or building from the ground up, this session will arm you with the tools and insights needed to transform your FME usage into a powerhouse of productivity. Join us to discover effective strategies that simplify complex processes, enhancing your productivity and transforming your data management practices with FME. Let’s turn complexity into clarity and make your workspaces work wonders!
GridMate - End to end testing is a critical piece to ensure quality and avoid...ThomasParaiso2
End to end testing is a critical piece to ensure quality and avoid regressions. In this session, we share our journey building an E2E testing pipeline for GridMate components (LWC and Aura) using Cypress, JSForce, FakerJS…
Communications Mining Series - Zero to Hero - Session 1DianaGray10
This session provides introduction to UiPath Communication Mining, importance and platform overview. You will acquire a good understand of the phases in Communication Mining as we go over the platform with you. Topics covered:
• Communication Mining Overview
• Why is it important?
• How can it help today’s business and the benefits
• Phases in Communication Mining
• Demo on Platform overview
• Q/A
Enchancing adoption of Open Source Libraries. A case study on Albumentations.AIVladimir Iglovikov, Ph.D.
Presented by Vladimir Iglovikov:
- https://www.linkedin.com/in/iglovikov/
- https://x.com/viglovikov
- https://www.instagram.com/ternaus/
This presentation delves into the journey of Albumentations.ai, a highly successful open-source library for data augmentation.
Created out of a necessity for superior performance in Kaggle competitions, Albumentations has grown to become a widely used tool among data scientists and machine learning practitioners.
This case study covers various aspects, including:
People: The contributors and community that have supported Albumentations.
Metrics: The success indicators such as downloads, daily active users, GitHub stars, and financial contributions.
Challenges: The hurdles in monetizing open-source projects and measuring user engagement.
Development Practices: Best practices for creating, maintaining, and scaling open-source libraries, including code hygiene, CI/CD, and fast iteration.
Community Building: Strategies for making adoption easy, iterating quickly, and fostering a vibrant, engaged community.
Marketing: Both online and offline marketing tactics, focusing on real, impactful interactions and collaborations.
Mental Health: Maintaining balance and not feeling pressured by user demands.
Key insights include the importance of automation, making the adoption process seamless, and leveraging offline interactions for marketing. The presentation also emphasizes the need for continuous small improvements and building a friendly, inclusive community that contributes to the project's growth.
Vladimir Iglovikov brings his extensive experience as a Kaggle Grandmaster, ex-Staff ML Engineer at Lyft, sharing valuable lessons and practical advice for anyone looking to enhance the adoption of their open-source projects.
Explore more about Albumentations and join the community at:
GitHub: https://github.com/albumentations-team/albumentations
Website: https://albumentations.ai/
LinkedIn: https://www.linkedin.com/company/100504475
Twitter: https://x.com/albumentations
Enchancing adoption of Open Source Libraries. A case study on Albumentations.AI
White paper dita for everyone
1. +
DITA For
Everyone
+
It’s not just for Tech Pubs!
Using DITA-based knowledge, experience, and tools
to help the whole organization succeed.
2. 2
1
ç
+
DITA FOR EVERYONE
It’s not just for Tech Pubs!
In the corporate world, the technical
made by technical publications organizations,
publications department is often viewed as a
the rest of the enterprise has not benefited from
cost center, necessary as a provider of content
the potential advantages of moving content to a
to support a packaged product or service
standards-based environment.
offering, but having no value to the core
revenue generation functions of the enterprise.
As a result, technical publications managers
must fight hard to get the budget for any new
technologies and must be prepared to show
strong ROI arguments to justify those
investments.
Is this a missed opportunity? Why hasn't DITA’s
success been replicated by other corporate
organizations that produce content? Why aren’t
other departments leveraging the skills and
knowledge of the technical publications staff to
increase their own value to the enterprise? This
paper will highlight some of the potential
Over the last decade, the implementation of the
benefits for these "other" corporate
DITA standard has greatly optimized the
organizations as they interact with the technical
creation, management, and publishing of
publications department, and provide some
technical content. DITA-based tools and
insights into how they can achieve similar
processes have resulted in dramatic cost
productivity gains.
savings and process improvements. However,
despite the large investment of time and money
3. 2
1
+
Intro
duction
“Content is king.” You’ve heard it
said in many corporate boardrooms.
With the increasing popularity of online search
And yet, despite the clear and proven benefits of
engines, cloud-based software, and mobile
DITA, not much else has changed for those
devices, the need to access relevant and
technical publications departments from a
useful content has never been more urgent.
cultural perspective across the enterprise. The
And yet, the people responsible for producing
success of a departmental DITA implementation
the technical information that supports
rarely extends beyond organizational
products made by these companies are often
boundaries to be replicated in other
hidden deep within the Engineering or IT
departments. In most cases, other organizations
organizations, struggling for respect and
do not recognize the benefits of DITA for their
relevance as they compete for budgetary
own content, and they are somewhat fearful of
survival.
the costs and time required to successfully
In their efforts to provide the most useful, rich,
implement a DITA solution for production use.
and effective content in the shortest possible
This paper will illustrate four
timeframe and for the lowest possible cost,
scenarios where the technical
many technical publications groups have
publications departments can use
embraced the DITA standard. By moving away
their DITA-based knowledge,
from proprietary authoring and publishing
experience, and tools to support
tools that require years to master, and by
cross-organizational success
adopting standards-based approaches to
across the enterprise, including:
content creation, management, and
multichannel publishing, these writing
•
Product Engineering
departments have been able to dramatically
•
Marketing
reduce cost and increase efficiency related to
•
One DITA implementation at a
Fortune 500 technology
company resulted in 40%
reduction in product
documentation costs.
By reusing 80-90% of their
content, the company reduced
product development time by
4-6 weeks and localization
costs by $800K per project.
Customer support/field
support
the content life cycle.
Structuring corporate technical content into
•
Training/Education
reusable “components” (tasks, concepts,
For each of these scenarios, we will describe the
topics), DITA-based environments have
typical current environment, the potential
resulted in dramatic cost savings and faster
benefits of DITA-based collaboration with the
time-to-market. As industry success stories
technical publications staff, and illustrate with
pile up, the proof is clear: DITA is a winning
examples based on real-life success stories with
proposition for managing the process of
the easyDITA™ platform for authoring,
producing technical publications.
management, and publishing of DITA content.
4. 2
1
+
Product Engineering
Typical Current Environment
In a typical technical publication process, a writer will
Content Review
interact with engineers and/or subject matter experts
Again, there is often no formal tracking process to
(SMEs) in several phases of development: to gather initial
determine the status of SME content review. Engineers
specifications in order to produce draft content and to
are often busy with development project tasks, and
facilitate the content review by the engineer/SME. There are
review of technical documentation is not always
often problems associated with each of these phases:
prioritized as highly as these other responsibilities.
Content contribution
SMEs typically do not follow a structured process for
Therefore, review comments are typically late and often
incomplete.
sending initial content to the writer. If the writer is lucky,
The most common mechanism for SME content review is
there will be formal specification documents that are
for a writer to send MS-Word or PDF documents via email
managed by version control and follow an approved format.
to each stakeholder in the review process. Each reviewer
If the writer is not as fortunate, the contribution can range
provides comments and edits to their own copy of the file
from a myriad of Word documents, email messages, Wiki
and returns the edited version to the writer. Once all
discussions, and even handwritten notes.
comments are received, it is up to the writer to face the
Often, there is no formal tracking mechanism in place to
determine if complete, up-to-date information has been
provided to the writer. If specifications are modified, the
writer often finds out too late (if at all).
challenge of consolidating these comments into one final
document - and even acting as a referee when comments
from different reviewers are not in agreement.
5. +
Benefits of a
DITA
Environment
A technology platform based
on DITA can help address
many of the issues with content
contribution and content
review:
A DITA component-based
content management system
Example: The easyDITA content management system has powerful versioning
and notification features. This screenshot shows a topic’s version history,
indicating who to notify if this content is updated in the future.
provides a centralized storage
area, with versioning to track
content as it is updated in the
system. Imagine if functional
specifications were authored
in DITA and stored in a
centralized repository: if a
specification was changed, an
automatic notification could
immediately be sent to the
technical writer.
A collaborative workflow
environment helps the writer
to determine who has
completed their review tasks
and who is overdue. It also
helps facilitate the
management of comments
from multiple reviewers and
encourage online
collaboration to resolve
discrepancies.
Example: easyDITA has robust automated workflow features, including an
intuitive browser-based review tool for SMEs to easily add comments and edits
to content, and reporting to show status of outstanding review tasks.
6. +
Marketing
Typical Current Environment
Marketing departments do not usually
What’s the issue?
have much interaction with technical
Some of the issues that marketing
publications groups. Marketing
organizations face include:
deliverables are vastly different from
product manuals, which tend to follow a
standardized, usually simple, format. In
contrast, marketing brochures,
newsletters, catalogs, and data sheets are
highly graphical in nature and very
layout-intensive.
Some marketing content is targeted for
web delivery (e.g., blog postings,
websites, etc.), while other deliverables
are primarily print-based. Due to these
factors, marketing organizations use a
variety of tools to produce their end
deliverables, ranging from simple web
editors like WordPress to highly
sophisticated layout tools like Adobe
InDesign.
The variety of content creation tools
make it inefficient to produce multiple
output formats. For example, a brochure
may have to be designed and produced
with a layout tool and then adapted later
for delivery to web or mobile devices.
Many companies serve a global audience
and have a need to produce multilingual
marketing collateral. Because marketing
content is usually developed in different
formats (e.g., Adobe InDesign files,
HTML, MS-Word, etc.), it can be costly
and time-consuming to translate these
deliverables into other languages with
the proper layouts.
7. +
Benefits of a DITA Environment
A DITA-based platform provides marketing organizations with an efficient way
to produce multiple outputs for web and print in multiple languages from a
single source.
Multi-channel publishing
Because DITA is based on “format-neutral” XML markup; the written content can be
created once and transformed to the required output formats in an automated way.
Tools exist to easily flow XML content into desktop publishing applications for further
layout, while delivery to online formats like HTML5 for delivery to the web and to
mobile devices can be completely automated.
Multi-channel publishing from the same source DITA content at the click of a
button from the easyDITA component content management system.
Multi-lingual output
DITA is a highly efficient format for content localization. Most professional translation
service providers have experience working with XML/DITA (and usually prefer it!)
When you receive localized DITA content back from your localization vendor, you can
use the same automated publishing processes for your target languages as you do for
your source language.
With easyDITA you can export and import content to and from your translation
partner for an end-to-end localization workflow.
8. Customer Support
In our experience, we’ve seen a mystifying phenomenon
at many large corporations: The customer support
organizations use issue-tracking systems and
knowledgebases to troubleshoot problems logged by
customers, while technical writing departments produce
manuals that are designed to help customers avoid having
to call customer support in the first place. Even though it
seems logical that there would be a symbiotic relationship
between these two organizations, in many companies
these departments are completely isolated from each
other and do not share information!
Benefits of a DITA Environment
A DITA-based platform provides significant
benefits to both the product support and
documentation organizations:
Because the technical writing teams typically
create DITA content at a topic level (e.g., task),
they can provide very discrete units of
information that are highly targeted and easy
to query against. If the support organization
could get direct access to these DITA topics,
imagine how much easier and more efficient it
would be to troubleshoot an issue!
Support engineers could provide valuable
feedback to the technical writing team. If a
support person finds mistakes or incomplete
information in a task, they could add
comments to the DITA topic and send it back
to the original writer for editing and
incorporation into the next product release.
This leads to potentially significant cost
savings and higher customer satisfaction,
because people would not require as much
customer support if the technical
documentation is more accurate and
understandable.
Example: easyDITA integrates with the intelligent content portal
SuiteShare, which can be configured as a support troubleshooting
tool using technical content authored in easyDITA. The illustration
above shows an example of SuiteShare configured to help customers
self-diagnose an issue.
9. 2
1
+
Training/Education
Typical Current Environment
Benefits of a DITA Environment
In another example of the “islands of content” dilemma, a
The primary benefits of migrating your training content
corporate training/education department is usually under a
to DITA are localization and consistency:
completely separate (often revenue-based) department
within the enterprise. Even though the educational content
Localization: By “chunking” your content into
being developed typically has a high percentage of overlap
reusable topics, you will only have to translate the
with the content produced by technical publications, there is
individual topics that have changed since the last
commonly very little content reuse between technical
localization cycle. Furthermore, because the content is
publications and training departments. In many cases,
marked up in format-neutral XML and can then be
learning content is developed redundantly to the technical
automatically rendered to several output formats, you
publications content, and is often stored in a completely
will no longer have to pay a localization service provider
different repository or Learning Management System (LMS).
for desktop publishing (DTP) in your target languages.
If the educational content is being developed for a global
These 2 factors have been shown to reduce localization
audience and needs to be localized, this content is also sent
costs by an average of 70% for many technical
out for a separate translation, at a real cost to the company.
publications groups!
Consistency:
Most popular tools in the “learning”
space (such as PowerPoint or Captivate) give the course
developer many creative liberties. As a result, the final
output from different courseware creators can look quite
different, thus diminishing your brand recognition.
10. 7 More Habits of Highly Successful DITA Teams
1. DITA encourages the writing of concise topics that can easily be
assembled in any order. For example, a training department could use a
DITA specialization to reuse technical writing topics and leverage it for
educational purposes.
2. DITA conditional processing allows one set of content to automatically
produce documents with different uses, like instructor and student guides.
3. Because DITA is format-neutral, the same source content can be
automatically output as print-ready manuals, PowerPoint slides, or
optimized for a tablet device.
4. The separation of content from presentation (style, format) frees writers to
concentrate on what they do best: create valuable content...instead of
spending time adjusting fonts and troubleshooting layout issues.
5. DITA/XML content is highly desirable as a language translation format. If
technical publications topics are already translated, other departments will
not have to spend as much money “re-translating” the content for their
needs.
6. If the DITA repository is robust enough, there may be no need to invest in
setting up and maintaining a separate content management systems like an
LMS, easing the burden (and associated cost) related to IT support.
7. A powerful DITA repository can also manage video and multimedia content
that could be shared by both the technical publications and other
organizations.
+
Jorsek LLC
302 N. Goodman St. e201
Rochester, NY 14607
(877) 492-2960
easyDITA.com