SlideShare uma empresa Scribd logo
1 de 14
Baixar para ler offline
© 2016 Aras aras.com
Technical Documentation
Kevin Richard, Product Manager
© 2016 Aras aras.com
Topics
 Solution Overview
▫ What are Technical Documents?
▫ Technical Documentation Challenges
▫ Aras Technical Documentation – Key Features
 Benefits
 Demo
 Q&A
© 2016 Aras aras.com3
Technical Documentation
 Examples
 User / System Manuals
 Training Material / Help Documentation
 Work Instructions
 Part Specifications / Catalogs
 Typically feature information about
products
 Have well-defined structure
 Increasing trend to consume
electronically
 Topics-based / modular
© 2016 Aras aras.com4
Challenges of Technical Documentation
 Ensuring documents are accurate and complete
▫ Regulatory/safety/commercial pressures
 Synchronization with documents as products evolve
 Version/Change management
▫ Managing changes between variants
 Maintaining consistency (content and style)
▫ Applying changes to existing documents
© 2016 Aras aras.com5
A New Approach
 PLM-based Document Authoring Environment
▫ Leverage Aras Innovator’s core functionality
▫ Web-based, no client installs
▫ Embed / reference content from managed Business Items
 Extensible document schema framework
 Extensible document style configuration
 Publishing framework with support for XML, HTML, and PDF
© 2016 Aras aras.com6
Structured Content
© 2016 Aras aras.com7
Tech Document
Title
Sub Title
Description
Graphic
Overview
Features
List
Components
Part Reference
Document Schema Defined by a Data
Schema, which controls:
▫ Types of document content
▫ Required vs Optional
elements
▫ Cardinality
 Enables:
▫ Compliance to company
Standards
▫ Consistency
Required Optional
Tech Document
Integrating with Business Items in PLM
© 2016 Aras aras.com8
 Include both new content
and reuse of existing
content
 Revision information is
maintained with the
document
Graphic
Graphic
Graphic
Part
Catalog Entry
Rev A
Catalog Entry
Catalog Entry
Catalog Entry
Tech Document
Managing Change
© 2016 Aras aras.com9
 Change in referenced
content may drive change
to associated documents
▫ As referenced content
evolves, Authors can
update documents
individually, or in batch
Graphic
Graphic
Graphic
Part
Catalog Entry
Rev A
Catalog Entry
Catalog Entry
Catalog Entry
Catalog Entry
Rev B
Enabling Document Variability
© 2016 Aras aras.com10
 Use Options to
characterize documents
and document content
▫ Provides a filter
 User-defined
 Applied to documents
and referenced content
Tech Document
Parking Brake Lever
Disassembly
1. Remove the floor console
2. Remove the rear air duct
3. Loosen the adjustment and unhook the wires
4. Remove the bracket from the console
5. Mark the position of the front nut
6. Remove the bolts and nuts that hold the lever mechanism. Lift out the
mechanism
1. Remove the floor console
2. Remove the rear air duct
Model: 9-3 *
2. Remove the rear air ductModel: 9-3 (9440)
Content Publishing
© 2016 Aras aras.com11
Tech Document
Part
Query/
Filters
Tech Document
Part
User
Innovator
Part
Graphic
XML
HTML
PDF
 Improved accuracy and completeness
▫ Embed / reference content from managed objects in PLM
 Ex. Parts, Operations, Graphics
 Version management
▫ Change Notification, etc.
 Meet regulatory requirements
▫ Enforce standard content and layout via schema
 Increased authoring productivity
▫ Structured: Ensures consistency
▫ Modular / Topic-based: Enables reuse
 Secure
▫ Access Control managed by Workflow/Lifecycle
© 2016 Aras 12
Benefits
aras.com
Product Availability
 Technical Documentation 11 R1 Released Dec. ’15
▫ Open to Community
 Subscribers get Export/Publishing capability
▫ Installation via new Aras Update Application
 New for SP5 Applications and Beyond…
 http://www.aras.com/support/downloads/download.aspx
© 2015 Aras aras.com13
© 2016 Aras aras.com

Mais conteúdo relacionado

Mais procurados

Dairy subcategory identity cards and product ranges - Europe - Foundation.pptx
Dairy subcategory identity cards and product ranges - Europe - Foundation.pptxDairy subcategory identity cards and product ranges - Europe - Foundation.pptx
Dairy subcategory identity cards and product ranges - Europe - Foundation.pptx
FarmerBrown2
 
QOS In Publishing Prospective
QOS In Publishing ProspectiveQOS In Publishing Prospective
QOS In Publishing Prospective
shakulbio
 
The Electronic Regulatory Submission
The Electronic Regulatory SubmissionThe Electronic Regulatory Submission
The Electronic Regulatory Submission
Dr.RAJEEV KASHYAP
 

Mais procurados (20)

Variant Management
Variant ManagementVariant Management
Variant Management
 
Elements of technical document
Elements of technical documentElements of technical document
Elements of technical document
 
DO 178C Upcoming Guidance for OOS
DO 178C Upcoming Guidance for OOSDO 178C Upcoming Guidance for OOS
DO 178C Upcoming Guidance for OOS
 
Technical writing
Technical writingTechnical writing
Technical writing
 
Types of Technical Report and Writing
Types of Technical Report and WritingTypes of Technical Report and Writing
Types of Technical Report and Writing
 
Post-NOC changes
Post-NOC changesPost-NOC changes
Post-NOC changes
 
SAP in Pharmaceutical Industry
SAP in Pharmaceutical IndustrySAP in Pharmaceutical Industry
SAP in Pharmaceutical Industry
 
Change control,SOP,PHARMA,R&D,QC,QA
Change control,SOP,PHARMA,R&D,QC,QAChange control,SOP,PHARMA,R&D,QC,QA
Change control,SOP,PHARMA,R&D,QC,QA
 
Investigational new drug application
Investigational new drug applicationInvestigational new drug application
Investigational new drug application
 
Software documentation
Software documentationSoftware documentation
Software documentation
 
Do 178 B Summary
Do 178 B SummaryDo 178 B Summary
Do 178 B Summary
 
Product Development Report Writing
Product Development Report WritingProduct Development Report Writing
Product Development Report Writing
 
eCTD Submissions
eCTD SubmissionseCTD Submissions
eCTD Submissions
 
Electronic batch record management in pharmaceutical industry
Electronic batch  record  management  in  pharmaceutical industryElectronic batch  record  management  in  pharmaceutical industry
Electronic batch record management in pharmaceutical industry
 
ICH eCTD 4.0
ICH eCTD 4.0ICH eCTD 4.0
ICH eCTD 4.0
 
Dairy subcategory identity cards and product ranges - Europe - Foundation.pptx
Dairy subcategory identity cards and product ranges - Europe - Foundation.pptxDairy subcategory identity cards and product ranges - Europe - Foundation.pptx
Dairy subcategory identity cards and product ranges - Europe - Foundation.pptx
 
Document Review Process
Document Review ProcessDocument Review Process
Document Review Process
 
QOS In Publishing Prospective
QOS In Publishing ProspectiveQOS In Publishing Prospective
QOS In Publishing Prospective
 
Software architecture document
Software architecture documentSoftware architecture document
Software architecture document
 
The Electronic Regulatory Submission
The Electronic Regulatory SubmissionThe Electronic Regulatory Submission
The Electronic Regulatory Submission
 

Destaque

Destaque (7)

Technical document
Technical documentTechnical document
Technical document
 
Guidelines for technical writing documents
Guidelines for technical writing documentsGuidelines for technical writing documents
Guidelines for technical writing documents
 
How to Choose the Best Healthcare Analytics Software Solution in a Crowded Ma...
How to Choose the Best Healthcare Analytics Software Solution in a Crowded Ma...How to Choose the Best Healthcare Analytics Software Solution in a Crowded Ma...
How to Choose the Best Healthcare Analytics Software Solution in a Crowded Ma...
 
10 trends reshaping digital - updated Q1 2016
10 trends reshaping digital - updated Q1 201610 trends reshaping digital - updated Q1 2016
10 trends reshaping digital - updated Q1 2016
 
Common Technical Document
Common Technical DocumentCommon Technical Document
Common Technical Document
 
2016 Thumbtack Small Business Friendliness Survey
2016 Thumbtack Small Business Friendliness Survey2016 Thumbtack Small Business Friendliness Survey
2016 Thumbtack Small Business Friendliness Survey
 
The 8 Biggest Mistakes Social Media Marketers Make and How to Avoid Them
The 8 Biggest Mistakes Social Media Marketers Make and How to Avoid ThemThe 8 Biggest Mistakes Social Media Marketers Make and How to Avoid Them
The 8 Biggest Mistakes Social Media Marketers Make and How to Avoid Them
 

Semelhante a Technical Documentation for Technical Publications

CTE_corporate_overview
CTE_corporate_overviewCTE_corporate_overview
CTE_corporate_overview
Aniket Biswas
 

Semelhante a Technical Documentation for Technical Publications (20)

LavaCon 2017 - Much Ado About Templates: Reduce the Learning Curve and Increa...
LavaCon 2017 - Much Ado About Templates: Reduce the Learning Curve and Increa...LavaCon 2017 - Much Ado About Templates: Reduce the Learning Curve and Increa...
LavaCon 2017 - Much Ado About Templates: Reduce the Learning Curve and Increa...
 
CTE Overview Presentation
CTE Overview PresentationCTE Overview Presentation
CTE Overview Presentation
 
2013 Perforce Collaboration Tour - MathWorks
2013 Perforce Collaboration Tour - MathWorks2013 Perforce Collaboration Tour - MathWorks
2013 Perforce Collaboration Tour - MathWorks
 
Cloud Economics, from TCO to ROI
Cloud Economics, from TCO to ROICloud Economics, from TCO to ROI
Cloud Economics, from TCO to ROI
 
Understanding saa s
Understanding saa sUnderstanding saa s
Understanding saa s
 
Material declaration template design best practice
Material declaration template design best practiceMaterial declaration template design best practice
Material declaration template design best practice
 
Whats New from Aras 2016
Whats New from Aras 2016Whats New from Aras 2016
Whats New from Aras 2016
 
Toc08 Goldthwaite Digitizing Your Backlist
Toc08 Goldthwaite Digitizing Your BacklistToc08 Goldthwaite Digitizing Your Backlist
Toc08 Goldthwaite Digitizing Your Backlist
 
Parameters for c# developers.pdf
Parameters for c# developers.pdfParameters for c# developers.pdf
Parameters for c# developers.pdf
 
West Putting Structured Documents to Work
West Putting Structured Documents to WorkWest Putting Structured Documents to Work
West Putting Structured Documents to Work
 
CTE_corporate_overview
CTE_corporate_overviewCTE_corporate_overview
CTE_corporate_overview
 
Architecting Design Development Test Request System in Aras
Architecting Design Development Test Request System in ArasArchitecting Design Development Test Request System in Aras
Architecting Design Development Test Request System in Aras
 
20141109 Agile Dev East 2014 Conf Lean Documentation
20141109 Agile Dev East 2014 Conf Lean Documentation20141109 Agile Dev East 2014 Conf Lean Documentation
20141109 Agile Dev East 2014 Conf Lean Documentation
 
Techcello at a glance
Techcello at a glanceTechcello at a glance
Techcello at a glance
 
NAO Technical Discovery ITT National Audit Office
NAO Technical Discovery ITT National Audit OfficeNAO Technical Discovery ITT National Audit Office
NAO Technical Discovery ITT National Audit Office
 
Pre-Con Ed: CA Software Asset Management - Key Customer Topics
Pre-Con Ed: CA Software Asset Management - Key Customer TopicsPre-Con Ed: CA Software Asset Management - Key Customer Topics
Pre-Con Ed: CA Software Asset Management - Key Customer Topics
 
W7
W7W7
W7
 
Taming the Beast: Test/QA on Large-scale Projects
Taming the Beast: Test/QA on Large-scale ProjectsTaming the Beast: Test/QA on Large-scale Projects
Taming the Beast: Test/QA on Large-scale Projects
 
Case study : New SAP S/4HANA on SUSE Implementation Business Benefits Achieved
Case study : New SAP S/4HANA on SUSE Implementation Business Benefits AchievedCase study : New SAP S/4HANA on SUSE Implementation Business Benefits Achieved
Case study : New SAP S/4HANA on SUSE Implementation Business Benefits Achieved
 
Admin technology training nov 2007
Admin technology training   nov 2007Admin technology training   nov 2007
Admin technology training nov 2007
 

Mais de Aras

Mais de Aras (20)

Implementing PLM in the Fast-Paced, Innovation Driven Prepared Foods Industry
Implementing PLM in the Fast-Paced, Innovation Driven Prepared Foods IndustryImplementing PLM in the Fast-Paced, Innovation Driven Prepared Foods Industry
Implementing PLM in the Fast-Paced, Innovation Driven Prepared Foods Industry
 
Client Technology Directions
Client Technology DirectionsClient Technology Directions
Client Technology Directions
 
Aras Vision and Roadmap 2016
Aras Vision and Roadmap 2016Aras Vision and Roadmap 2016
Aras Vision and Roadmap 2016
 
Aras Community Update 2016
Aras Community Update 2016Aras Community Update 2016
Aras Community Update 2016
 
MBSE and the Business of Engineering
MBSE and the Business of EngineeringMBSE and the Business of Engineering
MBSE and the Business of Engineering
 
Beyond ECAD Connectors
Beyond ECAD ConnectorsBeyond ECAD Connectors
Beyond ECAD Connectors
 
The PLM Journey of Justifying Change with Strategic Vision
The PLM Journey of Justifying Change with Strategic VisionThe PLM Journey of Justifying Change with Strategic Vision
The PLM Journey of Justifying Change with Strategic Vision
 
The Impact of IoT on Product Design
The Impact of IoT on Product DesignThe Impact of IoT on Product Design
The Impact of IoT on Product Design
 
Enterprise Agile Deployment
Enterprise Agile DeploymentEnterprise Agile Deployment
Enterprise Agile Deployment
 
Taking Manufacturing Process Planning to the Next Level
Taking Manufacturing Process Planning to the Next LevelTaking Manufacturing Process Planning to the Next Level
Taking Manufacturing Process Planning to the Next Level
 
Quality Systems
Quality SystemsQuality Systems
Quality Systems
 
The Power of Self Service Reporting
The Power of Self Service ReportingThe Power of Self Service Reporting
The Power of Self Service Reporting
 
Making users More Productive with Enterprise Search
Making users More Productive with Enterprise SearchMaking users More Productive with Enterprise Search
Making users More Productive with Enterprise Search
 
Understanding the New Content Modeling Framework
Understanding the New Content Modeling FrameworkUnderstanding the New Content Modeling Framework
Understanding the New Content Modeling Framework
 
Supplier Exchange Portal
Supplier Exchange PortalSupplier Exchange Portal
Supplier Exchange Portal
 
Quality Planning for Product Risk Management
Quality Planning for Product Risk ManagementQuality Planning for Product Risk Management
Quality Planning for Product Risk Management
 
How to Configure Tech Docs
How to Configure Tech DocsHow to Configure Tech Docs
How to Configure Tech Docs
 
Techniques for Gathering Agile Requirements
Techniques for Gathering Agile RequirementsTechniques for Gathering Agile Requirements
Techniques for Gathering Agile Requirements
 
Whats New in Visual Collaboration 2016
Whats New in Visual Collaboration 2016Whats New in Visual Collaboration 2016
Whats New in Visual Collaboration 2016
 
Simulation Data Management-Ansys
Simulation Data Management-AnsysSimulation Data Management-Ansys
Simulation Data Management-Ansys
 

Último

Último (20)

Exploring the Future Potential of AI-Enabled Smartphone Processors
Exploring the Future Potential of AI-Enabled Smartphone ProcessorsExploring the Future Potential of AI-Enabled Smartphone Processors
Exploring the Future Potential of AI-Enabled Smartphone Processors
 
How to Troubleshoot Apps for the Modern Connected Worker
How to Troubleshoot Apps for the Modern Connected WorkerHow to Troubleshoot Apps for the Modern Connected Worker
How to Troubleshoot Apps for the Modern Connected Worker
 
Developing An App To Navigate The Roads of Brazil
Developing An App To Navigate The Roads of BrazilDeveloping An App To Navigate The Roads of Brazil
Developing An App To Navigate The Roads of Brazil
 
Apidays New York 2024 - Scaling API-first by Ian Reasor and Radu Cotescu, Adobe
Apidays New York 2024 - Scaling API-first by Ian Reasor and Radu Cotescu, AdobeApidays New York 2024 - Scaling API-first by Ian Reasor and Radu Cotescu, Adobe
Apidays New York 2024 - Scaling API-first by Ian Reasor and Radu Cotescu, Adobe
 
How to Troubleshoot Apps for the Modern Connected Worker
How to Troubleshoot Apps for the Modern Connected WorkerHow to Troubleshoot Apps for the Modern Connected Worker
How to Troubleshoot Apps for the Modern Connected Worker
 
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot TakeoffStrategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
 
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
 
Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...
 
Understanding Discord NSFW Servers A Guide for Responsible Users.pdf
Understanding Discord NSFW Servers A Guide for Responsible Users.pdfUnderstanding Discord NSFW Servers A Guide for Responsible Users.pdf
Understanding Discord NSFW Servers A Guide for Responsible Users.pdf
 
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
 
Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)Powerful Google developer tools for immediate impact! (2023-24 C)
Powerful Google developer tools for immediate impact! (2023-24 C)
 
Data Cloud, More than a CDP by Matt Robison
Data Cloud, More than a CDP by Matt RobisonData Cloud, More than a CDP by Matt Robison
Data Cloud, More than a CDP by Matt Robison
 
presentation ICT roal in 21st century education
presentation ICT roal in 21st century educationpresentation ICT roal in 21st century education
presentation ICT roal in 21st century education
 
Boost Fertility New Invention Ups Success Rates.pdf
Boost Fertility New Invention Ups Success Rates.pdfBoost Fertility New Invention Ups Success Rates.pdf
Boost Fertility New Invention Ups Success Rates.pdf
 
Boost PC performance: How more available memory can improve productivity
Boost PC performance: How more available memory can improve productivityBoost PC performance: How more available memory can improve productivity
Boost PC performance: How more available memory can improve productivity
 
Axa Assurance Maroc - Insurer Innovation Award 2024
Axa Assurance Maroc - Insurer Innovation Award 2024Axa Assurance Maroc - Insurer Innovation Award 2024
Axa Assurance Maroc - Insurer Innovation Award 2024
 
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
Bajaj Allianz Life Insurance Company - Insurer Innovation Award 2024
 
2024: Domino Containers - The Next Step. News from the Domino Container commu...
2024: Domino Containers - The Next Step. News from the Domino Container commu...2024: Domino Containers - The Next Step. News from the Domino Container commu...
2024: Domino Containers - The Next Step. News from the Domino Container commu...
 
Finology Group – Insurtech Innovation Award 2024
Finology Group – Insurtech Innovation Award 2024Finology Group – Insurtech Innovation Award 2024
Finology Group – Insurtech Innovation Award 2024
 
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
Strategies for Unlocking Knowledge Management in Microsoft 365 in the Copilot...
 

Technical Documentation for Technical Publications

  • 1. © 2016 Aras aras.com
  • 2. Technical Documentation Kevin Richard, Product Manager © 2016 Aras aras.com
  • 3. Topics  Solution Overview ▫ What are Technical Documents? ▫ Technical Documentation Challenges ▫ Aras Technical Documentation – Key Features  Benefits  Demo  Q&A © 2016 Aras aras.com3
  • 4. Technical Documentation  Examples  User / System Manuals  Training Material / Help Documentation  Work Instructions  Part Specifications / Catalogs  Typically feature information about products  Have well-defined structure  Increasing trend to consume electronically  Topics-based / modular © 2016 Aras aras.com4
  • 5. Challenges of Technical Documentation  Ensuring documents are accurate and complete ▫ Regulatory/safety/commercial pressures  Synchronization with documents as products evolve  Version/Change management ▫ Managing changes between variants  Maintaining consistency (content and style) ▫ Applying changes to existing documents © 2016 Aras aras.com5
  • 6. A New Approach  PLM-based Document Authoring Environment ▫ Leverage Aras Innovator’s core functionality ▫ Web-based, no client installs ▫ Embed / reference content from managed Business Items  Extensible document schema framework  Extensible document style configuration  Publishing framework with support for XML, HTML, and PDF © 2016 Aras aras.com6
  • 7. Structured Content © 2016 Aras aras.com7 Tech Document Title Sub Title Description Graphic Overview Features List Components Part Reference Document Schema Defined by a Data Schema, which controls: ▫ Types of document content ▫ Required vs Optional elements ▫ Cardinality  Enables: ▫ Compliance to company Standards ▫ Consistency Required Optional
  • 8. Tech Document Integrating with Business Items in PLM © 2016 Aras aras.com8  Include both new content and reuse of existing content  Revision information is maintained with the document Graphic Graphic Graphic Part Catalog Entry Rev A Catalog Entry Catalog Entry Catalog Entry
  • 9. Tech Document Managing Change © 2016 Aras aras.com9  Change in referenced content may drive change to associated documents ▫ As referenced content evolves, Authors can update documents individually, or in batch Graphic Graphic Graphic Part Catalog Entry Rev A Catalog Entry Catalog Entry Catalog Entry Catalog Entry Rev B
  • 10. Enabling Document Variability © 2016 Aras aras.com10  Use Options to characterize documents and document content ▫ Provides a filter  User-defined  Applied to documents and referenced content Tech Document Parking Brake Lever Disassembly 1. Remove the floor console 2. Remove the rear air duct 3. Loosen the adjustment and unhook the wires 4. Remove the bracket from the console 5. Mark the position of the front nut 6. Remove the bolts and nuts that hold the lever mechanism. Lift out the mechanism 1. Remove the floor console 2. Remove the rear air duct Model: 9-3 * 2. Remove the rear air ductModel: 9-3 (9440)
  • 11. Content Publishing © 2016 Aras aras.com11 Tech Document Part Query/ Filters Tech Document Part User Innovator Part Graphic XML HTML PDF
  • 12.  Improved accuracy and completeness ▫ Embed / reference content from managed objects in PLM  Ex. Parts, Operations, Graphics  Version management ▫ Change Notification, etc.  Meet regulatory requirements ▫ Enforce standard content and layout via schema  Increased authoring productivity ▫ Structured: Ensures consistency ▫ Modular / Topic-based: Enables reuse  Secure ▫ Access Control managed by Workflow/Lifecycle © 2016 Aras 12 Benefits aras.com
  • 13. Product Availability  Technical Documentation 11 R1 Released Dec. ’15 ▫ Open to Community  Subscribers get Export/Publishing capability ▫ Installation via new Aras Update Application  New for SP5 Applications and Beyond…  http://www.aras.com/support/downloads/download.aspx © 2015 Aras aras.com13
  • 14. © 2016 Aras aras.com