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

2. 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

3. 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

4. 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

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

6. 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:
© 2016, STC INDIA CHAPTER 6 6

7. RESEARCH INDICATES…
© 2016, STC INDIA CHAPTER 7

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

9. 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:
Image source:
© 2016, STC INDIA CHAPTER 9 9

10. 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

11. THE DOLLAR PERSPECTIVE
© 2016, STC INDIA CHAPTER 11

12. 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

13. 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

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

15. 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

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

17. 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

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

19. FINALLY…THE BIRD’S EYE VIEW
Source:
© 2016, STC INDIA CHAPTER 19 19

20. 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

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