A DOLLAR PERSPECTIVE TO DEVELOPER DOCUMENTATION NIKHIL SULLURU PRINCIPAL TECHNICAL WRITER, ORACLE INDIA © 2016, STC INDIA CHAPTER 1

ABOUT THE SPEAKER Over 9 years of experience in different organizations as a Technical writer and a Software developer. Currently, Principal Technical Writer in the Oracle Fusion Applications team. Responsible for design, development, and delivery of REST API documentation for Oracle CRM products. MBA from Symbiosis Institute of Business Management, Pune and a B.E. from Anna University, Chennai. © 2016, STC INDIA CHAPTER 2

AGENDA Hybridization of Cloud Applications Complex Cloud Integration Challenges Role of Documentation in Simplifying Integrations Impact of Documentation on Total Cost of Ownership (TCO) Contribution of Documentation to Revenue and Return on Investment (ROI) © 2016, STC INDIA CHAPTER 3

KEY OBJECTIVES Understand the importance of developer documentation in the Cloud world. Justify why organizations should invest more in developer documentation. Describe how effective developer documentation can save an organization’s costs. Explain how developer documentation can be critical to a Cloud vendor’s revenue. Demonstrate how technical writers are redefining developer documentation. © 2016, STC INDIA CHAPTER 4

THE CLOUD IS THICKENING! © 2016, STC INDIA CHAPTER 5

SYSTEM INTEGRATION - A BIG CHALLENGE With a wide range of Cloud software and hardware available, users get to pick and choose what is best for them. Example: An enterprise can deploy an on-premise private cloud to host sensitive or critical workloads, but use a third-party public cloud provider, such as Google Compute Engine, to host less-critical resources, such as test and development workloads. A Cloud containing PaaS and SaaS from different vendors (which is the most common scenario) presents significant challenges in integration. As more features are added, the integration gets more complex. Image Source: https://www.mulesoft.com © 2016, STC INDIA CHAPTER 6 6

RESEARCH INDICATES… © 2016, STC INDIA CHAPTER 7

INVEST IN DEVELOPER DOCUMENTATION SOLUTION: INVEST IN DEVELOPER DOCUMENTATION © 2016, STC INDIA CHAPTER 8

CHANGE IN DOCUMENTATION FOCUS… Intuitive User Interface Every major software/hardware provider now has a wide range of solutions on the Cloud. Cloud has everything…Word processing applications (Office 365) to personal data storage (Dropbox) to complex enterprise applications. However, the rapid shift from on-premise applications to a hybrid mix of SaaS and on-premise applications has introduced big challenges for organizations attempting to simplify enterprise application integration. Image source: http://beyondplm.com/ Image source: http://www.gartner.com/ © 2016, STC INDIA CHAPTER 9 9

DEVELOPER DOCUMENTATION IS THE KEY… Ease of Integration Give Developers What They Want No “Lift and Shift” Without Documentation Total cost of ownership is a combination of the following costs: Startup costs Operational costs Retirement costs If it is Not Documented, it is Not Supported Do It Yourself! Varied Customers, Varied Integrations © 2016, STC INDIA CHAPTER 10 10

THE DOLLAR PERSPECTIVE © 2016, STC INDIA CHAPTER 11

TOTAL COST OF OWNERSHIP OF CLOUD APPLICATIONS Software Hardware Implementation Data migration Licenses Training Interface Customization Startup costs Maintenance Support High availability Training Patches Upgrades Custom enhancements User & admin support TCO Operational costs Retirement costs Data export Archiving Inactive licenses Support till EOL © 2016, STC INDIA CHAPTER 12

HOW DEVELOPER DOCUMENTATION IMPACTS TCO Implementation Data migration Training Customization Maintenance Support High availability Patches Data export Archiving Support till EOL Startup costs Operational costs Retirement costs Documentation can directly impact various types of costs that contribute to TCO. Effective documentation can decrease: The time spent on integration research Implementation costs including time and human resources Loss of productivity in migrating to Cloud Technical Support calls © 2016, STC INDIA CHAPTER 13 13

FACTORS THAT CONTRIBUTE TO REVENUE © 2016, STC INDIA CHAPTER 14

HOW DEVELOPER DOCUMENTATION IMPACTS ROI Tangible Factors Intangible Factors Service quality Competency levels Employee satisfaction Growth opportunities Focus on R&D Attract talent Revenue Customer satisfaction © 2016, STC INDIA CHAPTER 15

TECHNICAL WRITERS REDEFINING DEVELOPER DOCUMENTATION © 2016, STC INDIA CHAPTER 16

DEVELOPER DOCUMENTATION: CHALLENGES Historically, developed and maintained by Development teams. Lacked structural, style, and language quality. Never reached the intended users, though there was a volume of technical information available. © 2016, STC INDIA CHAPTER 17

THE MUCH REQUIRED VALUE FROM WRITERS © 2016, STC INDIA CHAPTER 18

FINALLY…THE BIRD’S EYE VIEW Source: http://www.oracle.com/ © 2016, STC INDIA CHAPTER 19 19

RECAP System Integration is emerging as a big challenge in the Cloud. Developer documentation can: Bring down organization’s TCO significantly. Increase your ROI. Developer documentation is probably the future of documentation. © 2016, STC INDIA CHAPTER 20

THANK YOU FOR YOUR PATIENCE… QUESTION TIME! THANK YOU FOR YOUR PATIENCE… © 2016, STC INDIA CHAPTER 21