John Robert Green

Technical Author

John Green

Technical Author

Download my résumé Send me a message

John Green, Technical Author

Interested in a long-term role with some remote working

I am have written about a wide variety of application software, using a selection of graphics, video and writing tools (with MadCap Flare being a favourite). To cut straight to a full work history, please download my résumé.

Also included on the site are the my attempts to debunk a few popular concepts (refer to Sacred Cows).


Full Name

John Robert Green


UK born and bred. UK passport holder.

Current Location


Find Me On


Software Documentation

Eston Ltd. (Full-time Course) - February to August, 1984

This was the first specialist Software Documentation course in the country. Following various coding and writing assignments, I took the City and Guilds in 'Technical Communication Techniques', and passed with Merit.

Post-Graduate Bilingual Secretarial Diploma

University of Central Lancashire (Full-Time Course) - September 1979 to June 1980

Post-Graduate Diploma for Bilingual Secretaries, with individual Royal Society of Arts exam passes in French (Advanced), Spanish (Intermediate), Office Supervision (Stage III), Typing (Stage III), Shorthand (80 wpm). I also took, and passed, the Diplôme de la Chambre de Commerce de Paris en français commercial.

Foreign Languages

Oxford University (Four Year Course) - Left after Three Years

BA Languages course in French and Latin, scheduled from October 1971 until June 1974.

Recent Work Experience

JSA Services contracting

Technical Author: February 2019-Present

Short-term software documentation contract at Research England in Bristol (part of UK Research and Innovation), using MadCap Flare. I underwent security clearance for the role, which can be transferred to other government positions.

Only two weeks' notice required.

RTL Group (Formerly Yospace)

Technical Writer: March 2018-January 2019

In conjunction with the Web and Mobile Developers, I created the user documents describing how to use the SDKs and APIs designed to support Yospace’s core SaaS platform. (The SDKs are particularly crucial for monetization in that these allow the generation of client-side ad analytics for SSAI.)

I also modified and updated the back end yospaceCDS platform documents that describe how to set up and administer the broadcast streams. The original user documents were written in Google Docs, but transferred over to a structured documentation tool (Paligo), which allows for re-use and the generation of both PDFs and HTML5 from a single source.

Perforce (formerly Programming Research/PRQA)

Technical Writer: February 2017-February 2018

Assignment to update the PRQA help for Developers of embedded software, within the legacy LaTeX system, at the same time as migrating it to MadCap Flare. I liaised with the Project Managers, Developers and Support Engineers to rewrite the documentation that is specific to the C and C++ components, and to the PRQA Framework GUI on which the components run. The aim was to provide a consistent, integrated, easily modifiable MadCap Flare source (in U.S. English) from which multi-format output could be generated.

World Programming

Technical Author: Jan 2010-Apr 2012

Initially, I created DITA XML-compliant documentation for the 3.2 release of the WPS analytics platform, including the user guide for the Workbench GUI (used to run SAS language programs). I also acted as head of the translation team responsible for localisation into French and Spanish (I did much of the French, and some of the Spanish, myself). I then worked closely with the Developers on the API-based 3.3 documentation for the WPS Matrix Programming module released at the end of 2016.

ice insure tech. ltd.

Technical Author: January 2014-February 2015

I worked with both the Marketing and Development teams to create the documents to aid the bidding process, including the end user worfklows for the Claims, Policy, Finance and Rating modules. I also created a back end Policy configuration guide. I introduced MadCap Flare to the Company, and persuaded them that Technical Authoring should form part of the Agile process. I used JIRA to raise defects.

Dell Software

Technical Author: January 2013-January 2014

Working in a remote but Agile environment, I helped to design the new interface for Version 6 of ChangeBASE. I explained the setup and basics of this interface by creating and narrating the Training and Marketing videos using Adobe Captivate, and then uploading them to Dell’s Learning Management System following approval. I also used MadCap Flare to create a conditioned single source user guide, and, from this source, generated all the required types of output (PDFs, CHMs, and HTML5.)

My position was part of a worldwide Dell redundancy programme.


Professional Skills

  • 90% Complete
    Communication 90%
  • 90% Complete
    Organisation 90%
  • 85% Complete
    Agile Methodology 70%

Software Skills

  • 90% Complete
    MadCap Flare 90%
  • 70% Complete
    DITA 70%
  • 40% Complete
    LaTeX 40%

Coding Skills

  • 80% Complete
    HTML5 / CSS3 80%
  • 70% Complete
    XML 70%
  • 40% Complete
    JavaScript 40%


Sacred Cows

The Result of the 2016 BREXIT Referendum must be respected

I am tired of hearing politicians say that they "respect" this result. Even if they do not believe it, they feel compelled to say it, for fear of being seen as enemies of democracy. This was fair enough at the time of the referendum, and for a while afterwards, but knowing what we know now in 2018/2019, I would love to hear some of them say, that, far from "respecting" it, they reject it and will do everything in their power to overturn it.

This is not being élitist - it is necessary in order to protect the UK, both economically and in terms of national security. As Jonathan Freedland said, writing in the 'Guardian' on 25 January 2019: "We are a man taking off his socks, bracing himself to walk barefoot across hot coals – for no better reason than he promised he would." (For the full article, click will-of-the-people-brexit-june-2016-leavers.) If it becomes obvious that, to "follow the will of the people" would put the country in a worse position, then it is the duty of the country's leaders to pull back and deal with any voter fallout - not just stagger blindly on until disaster strikes, and then turn round and say: "Well, this is what you voted for".

The BBC is Excellent Value for Money

The BBC is totally self-regarding, thinking that it has more power, influence and importance than it actually has. The substantial majority of people in this country no longer sit down together to watch terrestrial TV.

The sad thing is that, instead of addressing the core reasons for this waning of its power, it simply keeps gazing at its own navel and trumpeting its so-called achievements. As Libby Purves, the former Radio 4 presenter observed: "A new 'Doctor Who' is greeted like a Nobel Prize announcement, ‘Strictly' is like a cup final, and a bit of forgettable fiction like 'The Bodyguard' sparks chin-stroking discussion on [Radio 4’s] 'Today', for all the world as if something in the real world had happened. There's a fine line between civil, informative announcements and needy self-congratulation."

Why does the BBC constantly need to keep advertising its programmes, whether it's on TV or radio? We know the station to which we're tuned in, we know who's on air, and who's on air tomorrow. And don't get me started on the advertising of their tedious podcasts.

So, if the BBC doesn't start showing some humility and a sense of reality, there's no chance of it keeping up with the many streaming services that are now showing comparable, and often superior, content.

No wonder many viewers are not renewing their TV licences.

Social Media is Still a 'force for Good'

During the mid-2000s, social media started to completely change the way in which we communicated and shared information with one another. It was the force behind many subsequent revolutions, including ‘Occupy Wall Street’ and the Arab Spring. On a more mundane level, we could follow the lives of old friends that we hadn’t physically seen in years.

However, now, we see too much. And we can't stop ourselves, It's addictive, and the major platforms know it is, and start feeding us distorted versions of the truth to capitalise on our addiction. How do you think the 'Take Back Control' message perpetrated by the Brexiteers got out there? I still hear politicians parrotting that phrase - it's a form of brainwashing.

Not only that, it's also bad for mental health. For many years, we have had to put a 'gameface' on when going to work. Now we have to put a 'social media face' on as well, to tell all our followers that our lives are a roaring success. The resultant strain is ridiculous and unnecessary,

We just need to get the focus back on what's real and important. Having downloaded your favourite ad-blocking software, start creating your own truth.


How to get in touch

My LinkedIn Profile is Please send me a contact request.

Otherwise, please send me a standard email.

I'm always open to discussions about future opportunities.

Thank you.

"Life obliged me to do something to survive, so I wrote software documentation. Now I quite enjoy it."

John Green, January 2019. All rights reserved.