Technical Writing and Documentation Service Provider in Singapore


    The Journal of My Technical Writing Career

    A brief about me

    As a child, I dreamed of pilot, as a young boy I dreamed of being a doctor, but there are dreams that cannot be and storms we cannot weather. I am now a Writer in the business of informing, persuading, and evangelising through white papers, engineering blogs, Standard Operating Procedures, Developer Guides, User Guides, and Online Help. I am the bridge between engineers and end users, communicating the technical knowledge, arousing the reader's curiosity.

    My 'sweet spot'

    The process of learning excites meI love to research and convey complex information in a simple, understandable, and user-friendly formats. I am energised by the steady and deliberate journey from ignorance to competence. The thrill of breaking the barrier of ignorance, the early efforts to pen what I have learned, the growing confidence of a subject being mastered motivates me.

    My school days

    Technical Writer
    As a student, my goal was to be a top ranker in the class. I performed well in my studies and ranked among the top 10 students. On rare occasions, my rank slipped below my expectations, but I always bounced back. Life’s biggest goals were finishing exams, scoring well and traveling to my hometown - Kottayam, an adventurous journey by train for three days and two nights, passing through hills, mountains, rivers, fields, and tunnels. 

    After tenth, like every student in the science stream, my goal was to be a doctor or an engineer. I let go of all extracurricular activities and focused only on studies. In XII, most of us had private tuitions on top of what school teachers were already providing. But things didn't work out as per my plans. I did not qualify for an Engineering or Medicine seat. Based on the merit system, I enrolled for the bachelor's degree in Science from the M.S. University of Baroda



    My college days

    While in the first year, I still pursued my dream. I studied for medical entrance while I was doing BSc, but due to clashes in the examination dates, I let go of my dream and carried on with a renewed mind. I scored 62% in the first year and expected similar performance in the second year but to my surprise, I scored only 52%.

    During the final year BSc., I decided to pursue Masters in Computer Applications (MCA) and prepared for MCA entrance examination. To qualify for the entrance examination, I needed to score at least 60% in the final year BSc, so that the average of the second and third year comes out to be 55%. By God's grace, I managed to score 62% in the final year. 


    I appeared for the MCA entrance examination in May 1998. It was a miracle from God to see my rank in top 10. 

    When I attended the first semester classes, the subjects were very different from what I had studied until then. The programming languages were foreign to me. The only subjects that I was comfortable, were Maths and Economics. During the first year, I performed badly in the programming languages. But from the second year onwards, my grades improved. In the last semesters, I did projects at ABB and Railway Staff College. That was the time when I was exposed to the 'Internet' for the first time. In the overall three years of MCA curriculum, I scored first class. Praise God.

    During the college days, every student's goal was to get through campus interviews. In the fifth semester, 2001, companies like Amdocs, TCS, Patni, Wipro, MBT hired more than half the class of our MCA graduates. But in the later part of the year, due to dot-com bubble burst coupled with World Trade Center attack, companies canceled or postponed their job offers. It was a blow to those who were given job offer letters. Miraculously, I managed to get into a US-based startup company - Amtel Security Systems. I was interviewed by Suresh Gajwani, the founder, when he was on a visit to Baroda.



    The companies I worked

    At Amtel, I was involved in documentation, technical support, gathering customer requirements, writing persuasive RFP responses, assisting sales in identifying customer's business requirements and delivering technically correct solutions, testing, and even purchasing controllers and chips. I had a hands-on experience with almost everything except coding. I loved the RFID and security products and enjoyed my work there.

    I worked at Amtel for two and half years, but there was no salary increment. I decided to change the company. By this time, my programming skills got rusted, and I lost the passion for coding. The only option I had was to work as a Testing Engineer or Sales Engineer. While browsing for jobs in newspapers, I came across a post of Technical Writer that caught my attention. Until then I was not aware of a post called Technical Writer. 

    I gave two interviews, one with Impetus Technologies for Testing Engineer and another with Zensar Technologies for Technical Writer. I remember traveling Ahmedabad to attend the Impetus Technologies interview. Zensar conducted my interview via telephone.


    While in Kerala for our house-warming event, I first got the offer letter from Impetus. 
    Sagar Arondekar  wrote:
    Dear Abeesh
    We plan to extend you the offer letter. The present offer shall be 1LPA. It is customary to tell you that we have a bi-annually system of performance appraisal followed by increments. The date of joining is Feb. 01, 2004. Please reply in this regard along with your reachable contact no. as early as possible. We are trying your contact no. at Baroda but, it is not reachable.
    Hope to hear from you soon !
    Thank you
    Sagar Arondekar
    -Consultant HR
    Impetus InfoTech (I) Pvt. Ltd.
    14-B Sangam House,
    A.B. Road, Palasia,
    Indore - 452 008
    PH: 0731- 5069989 (O)
    or Call Ambrish Kanungo : 0731-3215247
    After reaching Baroda, I put forth my resignation and joined Impetus, Indore in Feb 2004 as a Software Testing Engineer. That was the first time I started living independently away from my parents. I was given a week's accommodation in a hotel. 


    Cross Roads
    Two weeks later, after joining Impetus, I got the Zensar Technologies offer for the post of Technical Writer with a better salary. I was in a dilemma whether to accept the offer since I was happy with the role of Software Testing Engineer. After much pondering, I decided to go for Zensar's offer that established my career as a Technical Writer, a road not taken by the MCA graduates.





    Geeta Janardhan  wrote:
    Hi Abeesh
    As discussed please find enclosed the salary break up. Please ack recpt of this mail and forward your mailing address to which i can courier the formal offer letter .
    regards
    Geeta

    Geeta Janardhan  wrote:
    Hi Abeesh
    Infact i mailed you y'day saying that i need to talk to you . I would like to talk to you about the offer we would like to make you . I would appreciate if you can call me else i will call if forward a number where i can call you.
    You can reach me at : 020-26631819 / 9823311272.
    regards
    geeta


    Two roads diverged in a yellow wood,
    And sorry I could not travel both
    And be one traveler, long I stood
    And looked down one as far as I could
    To where it bent in the undergrowth;
    Then took the other, as just as fair,
    And having perhaps the better claim
    Because it was grassy and wanted wear,
    Though as for that the passing there
    Had worn them really about the same,
    And both that morning equally lay
    In leaves no step had trodden black.
    Oh, I marked the first for another day!
    Yet knowing how way leads on to way
    I doubted if I should ever come back.
    I shall be telling this with a sigh
    Somewhere ages and ages hence:
    Two roads diverged in a wood, and I,
    I took the one less traveled by,
    And that has made all the difference

    At Zensar, I wrote documentation for the UML tool - BluePrint Foundry, created a help file using a freeware tool “Cheetah”, and wrote ADDL syntax Programmer’s Guide.


    Sometime in Oct 2004, I received an email for Technical Writing position with Samsung Electronics, South Korea. It was a great opportunity. I decided to appear for the interview by flying to Bangalore from Pune.

    Dear Abeesh
    We sourced your resume from Naukri.com. Consequently your candidature was shortlisted and an interview has been scheduled on Monday 18 Oct, 2004.
    The position is based out of our Hq in Korea in the Memory division.
    To know more about Samsung, please click here.
    In case you have queries, do reply. Once you confirm your attendance, I will send you a time slot.
    1. Samsung will bear two way economy class airfare (Pune- Bangalore -  Pune)
    2. You will have to buy the tickets and a refund in cash will be made during the course of the interviews, on production of ticket/counterfoil/boarding pass.
    Warm Regards,
    Samsung Electronics Co. Ltd India Software Operations
    Sriram Prabhakar
    Asst. Manager - International Recruitments

    Samsung India Software Operations
    Samsung Digital Plaza
    # 67 Infantry Road,
    Bangalore - 560001
    sriram.p@samsung.com
    www.samsungindiasoft.com
    Ph:080-2555 0555 Extn:3318

    After landing Bangalore, I took a taxi directly to the Samsung office. When I entered the meeting room, I was surprised to see a room full of Korean nationalities. The interview went well, but I was not sure of my performance.


    In November 2004, through God's favor, I received the confirmation letter from Samsung about my selection.

    During the same time, I received another offer from a company in Pune, but I decided to join Samsung Electronics. I resigned from Zensar Technologies on 10th Jan 2004.


    I arrived S. Korea on 21st Feb 2005. It was one of the coldest days with temperature below minus 15 degrees. You can read about my experience here http://www.thomasabeesh.com/2012/07/14/memoirs-of-south-korea/. I was with the Flash Management Software group, Memory Division, responsible for creating product documentation and white papers for Samsung's XSR, Whimory, RFS, and TFS4 file systems.

    Memory Division, Samsung Electronics
    Memory Division, Samsung Electronics
    The best part of working in Samsung, Korea was that they provided fully furnished flat, festival bonuses during Chinese New Year (Feb) and Chuseok Festival (Sep), performance bonus equivalent to 2-3 months salary, year ending completion bonus, two-way flight tickets to your home country, relocation allowance, and zero tax for foreigners with Master's degree and 3+ years of work experience. 
    Samsung Electronics Residence
    A view from my flat in S.Korea
    I enjoyed the weather in Korea especially the snow in winter. Some of the beautiful places I love there are Jeju, Busan, and Seoul. The company provided free Korean language training.

    When I joined the Memory Division, it was the most profitable division of Samsung Electronics. But in 2009 due to the global recession, the company suffered loss, and the management decided not to renew the contract for foreigners. Most of my colleagues opted to work in Samsung India, Bangalore.

    Before the turn of these events, I had decided to work in the UK. In October 2008, I applied for the Tier 1 work permit (HSMP) and within a week, it was approved. I could stay in the UK and look for a job without requiring any company to sponsor my work permit.

    After my contract with Samsung, I arrived UK in March 2009. But it was an economic recession there too. I stayed at Cambridge with a Nigerian family for a monthly rent of 350 pounds. It was through them; I got the chance to attend the African-American Worship service at the City of David Church - one of the most vibrant and energetic people I ever met in my life. While staying in the UK for three months, I managed to get three interviews in Bristol and Cambridge, but no success. I decided to return India to continue my career as a technical writer. On June 2nd, 2009 I left Cambridge and came back to my hometown - Kottayam. In the mid-June, out of blue, I received an email from a consultancy in Singapore for the post of a technical writer with Savi Technology - A Lockheed Martin Company



    From: Priyadarshini
    Subject: INTERVIEW WITH SAVI TECHNOLOGY
    To: "'ABEESH THOMAS'"
    Date: Friday, June 26, 2009, 4:06 AM

    Hi Abheesh

    ALL THE BEST

    YOUR INTERVIEWS WITH SAVI TECHNOLOGY


    Today  (25th June 06, Friday)
    Time: 8:30 PM
    Interviewer: Beth Conover, Principal Information Developer and Editor at Savi, USA  

    Tomorrow (26th June 09, Saturday)
    Time: 8:30 PM
    Interviewer: Les Kyono, Director Information Development, USA

    Please acknowledge my mail

    Regards

    Priyadarshini
    Manager - Technical Resources
    Nityo Infotech Services Pte. Ltd.
    260 Tanjong Pagar Road
    #08-02/03
    Singapore 088542
    Mobile No: +65-96778443
    Office No.: +65- 6327 7227
    Fax No.: +65- 6226 2890




    Singapore was never in my radar. I had never dreamed of working there. But God had a plan for me.

    Singapore
    Singapore
    There were five rounds of telephonic interview with Information Development (ID) Manager, Principal Writer, ID Director, Product Manager, and Vice President of Savi, Singapore. By God's favor, the interviews were successful, and I was selected to work in Singapore for Savi Technologies. I was supposed to join on July 15th, 2009 but later I discovered that I could not travel since my passport validity was less than six months. I applied for the tatkal passport in Kochi and got my passport after seven days. It took another one week to get my employment pass from the Singapore MoM.  I was provided the flight tickets and two weeks accommodation at Spottiswood Park, Tanjong Pagar. On July 26, 2009, I arrived Singapore and joined Savi Technologies. It was my first experience to work in an Agile Scrum environment.  I wrote SDK Installation Guide, User Guides, Installation Guides for Savi’s SmartChain RFID applications, using  XMetal as a Single Sourcing tool for generating content in various formats such as Online Help, CHM, and JAR files, and performed quality assurance and usability testing in the process of producing user documentation.

    Savi Technology Collegues
    Savi Colleagues
    After working there for a year, in August 2010, due to company's financial performance, the US office decided to outsource the development work to the Pune office in India. Nobody expected the closure of operations in Singapore.The employees were given the choice to work in India, but nobody opted for it. In the middle of September, through God's favor, I received two offers, one with Philips Electronics and another with Tagit Pte Ltd, for a one-year contract. I was in dilemma to choose the company since both offered the same pay package but I decided to go for Tagit. My responsibilities were to create user guides, installation guides, and training materials for the mobile banking application, Mobeix. 

    In August 2011, history repeated itself. Due to the financial situation, Tagit started cutting staff, and I was also laid off. Since I was employed through consultancy, they tried their best to find another client but no success. Meanwhile, I applied for PEP and got approval within three weeks. I could work for any company in Singapore without requiring a company sponsored work permit.

    In the first week of October 2011, I got an interview call for a technical writing position with PayPal, an eBay company, at Suntec City, Singapore. It was a six months contract position. There were four candidates vying for the same post. On Oct 10, a day before my birthday, I got confirmation about my selection. Praise God. My responsibilities were to create API documentation for their SOA based financial instrument services. 

    On February 29, 2012, I received a call from the consultant informing that my last working day would be on April 16th, 2012. I was taken by surprise since I expected an extension of my contract.

    I started applying for jobs. In the third week of March 2012, I got an interview call from JDSU Test & Measurements Singapore Pte Ltd, a US based Telecom company. I attended the interview and within two weeks, I received confirmation about my selection. All praises to my Lord and Savior Jesus Christ. One thing I know for sure, God can do it again and again when you call Him. After my selection, PayPal wanted to extend my contract for three more months, but it was too late.

    After working at JDSU for three years and two months, the company split into two different groups, Viavi Solutions, and Lumentum. Because of the split, it carried a burden of 50 million USD. To manage the expenses, JDSU decided to close the R&D division in Singapore, phase by phase. I was given a month's notice period. The company provided the relocation expenses and three months salary for the number of years I worked.

    A week before leaving Singapore, I got an interview with NextLabs, through referral from an ex-colleague. I cleared the first round which comprised of a written test, interview with a product lead, and with the director. The second round was a telephonic interview with a senior writer in the US. I cleared that and then there was a third round of telephonic interview scheduled on 29th July with the VP of the R&D division from the US. 

    I also had an interview scheduled with a different company on 30th July, but my visa was valid until 26th July. I went to ICA Singapore, to extend my visa, but it was denied.

    While in India, I completed the third round of the telephonic interview and submitted three references of my previous company as per the NextLabs HR policy.

    After two weeks, I received confirmation of my selection. The company applied for my Employment Pass, which was approved within a week. Praise God for His favor. After I joined the company on 26th August 2015, I came to know there were other candidates vying for the same post. 


    Life was going smooth, I was enjoying the workplace, people were cooperative, there were new products coming up that needed constant documentation. We went for occasional team outings and were having fun. In the month of March 2017, we got our salary after a delay of 2 weeks. It was the first sign of financial trouble. During the quarterly all-hands meeting in May, the CEO indicated about the possibility of pruning the workforce if the situation didn't improve. I was nonchalant. On June 7th, when I entered the office, the admin was not in her seat. I came to know she was let off the previous day. At 1 pm, as I was about to go for lunch, the director called me to a meeting room. I was informed that it was my last day in the office. With all the leaves and 2 weeks notice period, my official last day would be July 4th. I would get my salary until July 4th but I need not come office. I was calm. I knew God was in control and something better would turn up. As I was packing my stuff, there were few other employees given the termination letter.


    I started updating my resume on the job sites. I managed to attend 5 interviews in a span of 2 months. That's a great miracle in itself. Some of the interviewers gave high hopes as if they were about to hire me the next day but at the last moment they backtracked.

    I got confirmation from Xchanging, a DXC Technology company, but they wanted me to relocate to Kuala Lumpur, Malaysia. I gave my consent for relocation and they applied for my EP. Two weeks later, I got an interview offer with Veritas Technologies, in Singapore for a one-year contract. They confirmed my selection after a week. I had to renege the Malaysian offer but it was cordial. Since my Singapore visa was valid until 4th August, we left for Kerala on 31st July. Meanwhile, the company applied for my EP on 3rd August, MoM approved the application on 25th, and I joined the company on 30th August. All glory to my Lord Jesus Christ.


    At Veritas, my primary responsibility was to complete the documentation for the GovTech Singapore Backup-as-a-Service Cloud project. I finished that by the end of December 2017. There was not much work after this project. In Jan 2018, I applied for the technical writing position with a "reputed" startup company in Singapore. It was a permanent position. There were 2 rounds of interviews. In February, I received confirmation about my selection. I submitted my resignation with Veritas, gave 1 month notice period, and joined the new company in April 2018! All Glory to God!

    Why Hire Me?

    I am surprised to see advertisements from high-tech companies in Singapore, looking for Technical Writers with just 2 to 3 years of experience. I believe it is because of the cost factor to hire experienced writers with 10+ years of experience. But the companies that adopt such an approach are unaware of its effect on the documentation quality. Technical documents are designed to convey information clearly and persuasively but there are no definite, measurable standards to judge. It's possible that writing can be error-free and still not communicate effectively. There are no algorithms for writing. It takes years of experience and mentorship for writers to come out with quality documentation. The key to writing a good document is that it has to be a good experience for both - the writer, and the reader. The satisfaction of the writer and the reader are interwoven.You wouldn't want a novice taxi driver to ride you to your destination. Nor would you want a novice doctor to treat your medical condition. But writing? Can everybody do it? If your documentation is written by engineers, you risk satisfying your customers. Check this link for potential costs of poor or missing documentation   http://www.stc-berkeley.org/MonthlyMeeting/october2012_meeting/Devney_Handout_2.pdf


    Technical Writing is an art as well as science. We practice our craft to service the reader. We don't expel raw material; we transmute it to provide what the reader most wants.Technical Writers are not magicians who can generate content out-of-blue. We need a thorough understanding of the product before we can come out with the first draft. That's why it's important to interact with product engineers, testing engineers, and product manager to gain a first-hand knowledge of the product before coming out with the first draft. 
    When a writer has to work on multiple products, it is economical from the company's standpoint, but from the writer's perspective, it does not allow him to master the product.  Time is critical when a writer has to work on multiple products.

    My Advantage
    • Excellent interpersonal skills
    • Excellent communication skills 
    • IELTS score 8
    • Master of Computer Applications (MCA) and Bachelor of Science (Physics)
    • More than 15 years of writing experience with reputed companies
    • Mentored by professional Writers and Editors
    • Expert in using documentation tools such as XMetal Author, Robohelp, Altova XML Spy, Adobe FrameMaker, Microsoft Word, Microsoft Visio
    • Expert in creating API Documentation, SDK Developer Guide, User Guides, Installation Guides, White Papers, Training Materials, and Standard Operating Procedures (SOP)
    • Worked in Agile Scrum and Waterfall environment
    • Expert in working with version control tools such as GIT, Tortoise Subversion, ClearCase, and Snapshot CM

    Domain Experience
    • Telecommunications
    • Electronics
    • Mobile applications
    • Software
    • Security Systems
    • Financial Instruments
    • Client-Server applications
    • Scientific instruments

    If you have any questions, or you want to hire me, send me an email at abeeshthomas@yahoo.com.

    If you want to outsource your writing and documentation projects, visit ThomasEcafe.com, email: info@thomasecafe.com, or call +65-82086393. 

    Principles of Technical Writing

    This post provides a look at the "technical writing principles" I've found useful in helping writers to become highly effective and valued as a member of an engineering team.



    Have a positive attitude
    You have to know how to collaborate and be a good judge of people. Additionally, you must be willing to interact with different personalities of the people you are working with. There is an innate skill to draw information out of people or get your work reviewed by the SMEs without aggravating them. The success you experience as a writer depends 100% on your attitude. Sometimes, you may be given an assignment that has nothing to do with user documentation. But you must display a positive attitude towards such requests. 
    Quality should be the priority
    Your job is to make sure that your work is complete, correct, thoroughly fact-checked, and technically reviewed. Make sure that when you start something, you actually
    complete it. If people know they can rely on you to do high-quality work, you will win the trust.
    Communicate, Communicate, and Communicate
    Writers should strive to be superior communicators, as ineffective communication leads to confusion and reflects poorly on the entire team. The writer will be judged by the quality of his work. For better quality, communication is the key factor:
    • Documentation Plans - Make it clear to all stakeholders' what document outputs to expect at any given point of time in the product life-cycle.
    • Review - Use the Google doc or Adobe Shared Review process to receive feedbacks.
    • Communication via emails/chats/meetings - Keep the stakeholders informed about the progress of your documentation. Use the email meeting to schedule appointment with SMEs, and Product Managers. Ad-hoc chat also works depending on your relationship.
    Know your assignment
    Like it, or not, writers are 'contractors’ who are hired to provide User Manuals, API documentation, Training Materials, Engineering Blogs, etc. Technical documentation is meant for users of the engineering product. The users may be within the company but external; they may be engineers or layman. Understanding the users will help to improve the quality of the writing and, ultimately, the quality of the product.
    Avoid ambiguity
    This implies "Never presume" and clarify whenever there is ambiguity. Making speculation about how a product’s features/functionality, schedules, etc. will lead to a variety of issues:
    • Wrong content
    • Incomplete work
    • Bad impression on the documentation team
    Writers must avoid ambiguity in the documentation so as not to muddle others.
    Inhale and Exhale Content
    Writers 'live and breath' content. They consume content, and they create content. Practice your craft to serve the readers. Don't expel raw material but transmute it to provide what the reader most wants.
    Trust facts - Question assumptions 
    Related to the principle of avoiding ambiguity, writers must never make assumptions. As doing so can have a significant impact on the entire business.
    Writers must:
    • Work with the cross-functional team to address issues with requirements, user stories, etc.
    • Clarify schedules/expectations when in doubt.
    • Leverage documentation plan to articulate and set expectations on the documentation.
    • Track/manage outstanding issues until they are resolved.
    • Ensure a thorough document review by engineers and stakeholders.
    Think innovation
    Regardless of your busy schedule, writers must think out-of-box. Improvement ideas should be socialised, shared and investigated with managers and writers. Small changes can make a huge difference to the organization. Innovation that can benefit the documentation is always welcome.
    • Tweaks to processes, templates, style guide
    • Suggest better tools
    • Use videos where possible
    Remember, the companies are always looking for ways to increase efficiency and make the most out of the limited documentation budget.
    Embrace restrictions
    On the surface it may appear as if style guide does, in fact, restrict the writer; however, if you dig deeper you will discover that style guide helps by improving communications by establishing consistency in all the documents.
    Plan wisely
    A well thought out and a documented plan is worth its weight in gold. The documentation plan is the primary tool used to set expectations for all the stakeholders. There is a limited budget for documentation, and it is your responsibility to ensure the effectiveness of the plan such that it provides the highest ROI (Return on Investment).
    Identify priorities
    At the end of the day, the most important Technical Writing principle is "If you do not know - ASK".  Writers are expected to ask questions until they are confident that they have the information needed to write content. Just remember, unanswered questions contribute ambiguity to the content and add risk to the business.

    If you have questions, email me at abeeshthomas@yahoo.com. 

    How I write a White Paper

    An Overview of  White Paper

    White papers are a favorite marketing tool for companies. Companies aim to sell products as solutions to their customers through a white paper. The white papers educate readers and enables them to make decisions in choosing the solution that suits their needs. In this case, the white paper becomes an excellent marketing and SEO tool that advertises the company's products or services. Check this link about when you need to have a white paper.

    But writing a white paper is a challenging task. It involves an in-depth study of the product and its application, gathering information from the subject matter experts, and reviewing the product design documents. The objective is not only to convey information but to spark reader's interest to engage him in reading the rest. Precision and clarity are the watchwords. Naked facts are not enough to invite a reader's invitation to the rest of the document. It's their context- the writing, the container of the information - that illuminates facts for the reader and gives them significant meaning.

    A typical length of a white paper varies from 8-12 pages.


    How I write a white paper

    I meet the product owner, understand the requirements, check the target audience, ask for a date of completion, and request for an introduction or a demo of the product.

    After the preliminary discussion, I do my own research. After gaining sufficient knowledge, I write the first draft, juxtapose words, and convey information that gives a richer experience to readers.

    Occasionally, the first draft may not meet the expectations. Every good writer knows that the first draft of any piece of writing rarely resembles the polished, final version. It can be due to many factors such as I might have missed certain features, or it might not have been discussed in the first meeting. I then have a second round of discussion. This is when I get new insights. I capture these intricate details and put them in my second draft. This draft is almost a perfect piece. Over the years, I have learned that a writer needs a tough skin, for no matter how advanced one's experience and career, expert criticism cuts to the quick, and one learns to endure and to perfect. Writing is
    iterative, and a text reaches its full potential through multiple drafts, feedback, revision, and editing.


     Principal components of a white paper

    • A good page layout - A good page layout ensures that language, graphics, and colors combine on a page to promote clear communication. Readers of the page will find it pleasing and easy to read even though they may not be conscious of all the page layout techniques.
    • A title that arouses curiosity - A good title is the title of a successful white paper. A good title is like coming to a house you have never been in before and having the owner open the door and say "Welcome". A good title can make a tremendous difference in the early acceptance of a white paper.
    • Table of Contents - TOC help readers in two ways: 1. they outline the structure of the document and thus provide insight into the document's organization. 2. they provide the page numbers for all sections and subsections, thus helping readers to locate parts of the document.
    • Background/introduction to the document - The introduction sets the stage. It normally includes the historical background of the product and establishes the scope of the product. In essence, the introduction is a road map, it orients the reader by providing a context for the reading. In short, the introduction prepares the reader for what will follow. 
    • Graphics - Graphics are essential for conveying key information in the white paper. Readers will recall one impactful graphic long after they have forgotten a thousand words of text. Create visuals first, write text last. Graphics are more emphatic than text and should, therefore, be designed early in the writing process.
    • How the product solves the problem
    • System functions
    • Benefits of the product.
    • Architecture of the product
    • Evaluation criteria for choosing the product
    • Conclusions

    If you need help in writing a white paper, email me at abeeshthomas@yahoo.com or call +65-82086393.

    Essential Tips for Writing a Technical Article


    Writing a Technical Article

    Tips for Technical Writing

    • Get to the Point  - Your objective is to make the reader understand your topic quickly. The readers are not interested to spend hours reading the article.
    • Avoid wordy phrases. A fundamental of good writing style is to avoid unnecessary words.  Do not say All of a sudden. Just say, suddenly. Instead of a later date, say later. The shorter, simple words or expressions make your writing more concise and, consequently, make it look and sound more professional. 
    • Keep it Short and Simple - Write short sentences by eliminating punctuation without affecting the readability of the sentence. Use fewer commas, more periods, and no semicolons at all, if possible.
    • Improve the Presentation - Always provide a brief description of the subject followed by steps to achieve. Provide screenshots where possible.
    • Improve your Template - Use numbering if the steps are to be performed in a sequential manner otherwise use bullets. The title and headings should convey the subject matter. The headings, steps, and body text should follow a consistent format.
    • Use a Style Guide - Follow your company style guide. Otherwise, use Chicago Manual of Style or Microsoft Manual of Style.