dr. ugur akinci | tcc6.com 1 · "working for a software company: career advice and best...
TRANSCRIPT
![Page 1: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/1.jpg)
Dr. Ugur Akinci | TCC6.com
All images are used with Creative Commons license
1
![Page 2: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/2.jpg)
TCC6.com 2
![Page 3: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/3.jpg)
Rajdeep Gupta
STC India Vice President and former STC India President
Managing Director at Blue Dots Consultancy Services, STC DCSA Recipient, SaaS, Mobile Management, Geo Business Dev
3TCC6.com
![Page 4: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/4.jpg)
"Working for a Software Company: Career Advice and Best Practices"
1) My background
2) Structure of a software company
3) Tech writer's place in the Product Life Cycle
4) 5 challenges for tech writers
5) Best practices for survival and success
4TCC6.com
![Page 5: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/5.jpg)
BONUSAt the end of my presentation I will give out an unannounced BONUS to every participant of this webinar.
I think you’ll enjoy it!
So make sure to stick around
5TCC6.com
![Page 6: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/6.jpg)
6TCC6.com
![Page 7: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/7.jpg)
Studied Electrical Engineering and Sociology
Worked as NATO translator Desktop publisher Journalist Technical writer since 1998
OVERALL: A writer for 30 years
7TCC6.com
![Page 8: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/8.jpg)
8TCC6.com
![Page 9: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/9.jpg)
STC Associate Fellow (2015)
Past President, STC Washington D.C. Baltimore Chapter
Current member of Chapter’s Administrative Council
9
![Page 10: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/10.jpg)
DEPARTMENTS:
1. Marketing & Sales
2. MARCOM
3. HR & Finance
4. Development
5. Testing & QA
6. Documentation
7. Customer Service
8. Field Reps
10TCC6.com
![Page 11: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/11.jpg)
Marketing & Sales
WHAT DOES THE CUSTOMER WANT?
TECH WRITER’S CONTRIBUTION:
MRD (Marketing Requirements Document)
11TCC6.com
![Page 12: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/12.jpg)
SW Design
TECH WRITER’S CONTRIBUTION:
Design Specs Document
12
![Page 13: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/13.jpg)
Coding
TECH WRITER’S CONTRIBUTION:
SDK (Software Development Kit)
Objects, Methods, Procedures, Libraries, etc.
API (Application Program Interface)
Commands, messages and descriptions
13TCC6.com
![Page 14: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/14.jpg)
Unit, System, QA Testing
TECH WRITER’S CONTRIBUTION:
Testing Scenarios
14TCC6.com
![Page 15: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/15.jpg)
TECH WRITER’S CORE DOMAIN
Documentation Plan
SMEs
Existing Documents
Product Testing
Interviewing
Responding to “tickets”
15TCC6.com
![Page 16: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/16.jpg)
MS Office
FrameMaker (TCS5)
RoboHelp (TCS5)
Photoshop & Illustrator
SnagIt
AGILE
SourceSafe
JIRA
Subversion
16TCC6.com
![Page 17: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/17.jpg)
Product is developed. You write the document. And you deliver.
MRD
Code
TestDoc
Feed
Product
Doc
Deliver
17TCC6.com
![Page 18: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/18.jpg)
Customer A wants X
Write Doc X
Customer B wants X+Y
Write Doc X+Y
Customer A wants X-n
Write Doc X-n
Customer C wants 2X+Z
Write Doc 2X+Z
Etc.
18TCC6.com
![Page 19: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/19.jpg)
Overlapping Cycles
MRD
Code
TestDoc
Feed
MRD
Code
TestDoc
FeedMRD
Code
TestDoc
Feed
12
3
19TCC6.com
![Page 20: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/20.jpg)
Document Set Control
User Guide Light Edition Pro Enterprise
Installation Guide
Quick Start Guide
Help File
System Admin & Config Guide
A&E Specs Document
Release Notes
Web Interface Guide
Licensing Forms
Compatibility Matrix
Version Comparison Chart
Illustrations & Graphics
Etc.
20TCC6.com
![Page 21: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/21.jpg)
Version Control
AGILE
JIRA
SourceSafe
Subversion
21TCC6.com
![Page 22: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/22.jpg)
File Control
File & Directory Name GUIDELINES (Doc Number)_Title-Description_(DATE) E.g., “9-24387V4_Super_Guard_User_Guide_August_22_2015.doc “
Style & Branding GUIDELINES
Document TEMPLATES
22
![Page 23: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/23.jpg)
Review Management
OPTIMUM Number of reviewers (ideally, stated in DOC PLAN)
Allow as much time for reviews as writing
You have to DRIVE the process and stay on top of it!
23TCC6.com
![Page 24: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/24.jpg)
Usability (UX)
The IDEAL and the REALITY
24TCC6.com
![Page 25: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/25.jpg)
DOCUMENTATION PLAN
Scope
Stake Holders
Review Team
Calendar with Milestones
Chapter Summaries
Prerequisites
Risk Factors
Approvals & Signatures
25TCC6.com
![Page 26: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/26.jpg)
Be a nice helpful team member
Learn EVERYDAY: The product Tools & techniques
Keep an eye on your files
Volunteer new ideas
Drive the review process
Show interest in other teams
Don’t be afraid to ask
Be proud & happy!
26TCC6.com
![Page 27: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/27.jpg)
1) My background
2) Structure of a software company
3) Tech writer's place in the Product Life Cycle
4) 5 challenges for tech writers
5) Best practices for survival and success
27TCC6.com
![Page 28: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/28.jpg)
28TCC6.com
![Page 29: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/29.jpg)
UNANNOUNCED BONUS
29TCC6.com
(Drumroll please...)
![Page 30: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/30.jpg)
30
I hope it’ll help you in your career!
![Page 31: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/31.jpg)
31TCC6.com
![Page 32: Dr. Ugur Akinci | TCC6.com 1 · "Working for a Software Company: Career Advice and Best Practices" 1) My background . 2) Structure of a software company. 3) Tech writer's place in](https://reader033.vdocuments.us/reader033/viewer/2022060423/5f19af4e78bbb96de34aa6e5/html5/thumbnails/32.jpg)
TCC6.com
TECH DOC COMPETITIONhttp://wdcb.stcwdc.org/prof-dev/competition/about-the-competition/
FREE TECH WRITING NEWSLETTERhttp://www.technicalcommunicationcenter.com/free-ezine/
THANK YOU!32