What is an API?

MiscellaneousTechnology

What is an API?

September 20, 2016

An API is not a thing, it is a weird presence we communicate with, develop and implement. An API is an abstract idea, which is hard to catch for non-developers.

I find some concepts challenging to truly understand, let alone explain without context. Take language or loyalty for example. Or an API. What is it? Like Schrödinger's cat, such abstract concepts loose their real characteristics if we try to pin a static definition on them. But if a feline entity is so useful in explaining the quantum state, maybe metaphors would work for APIs too. I studied quantumchemistry, so you see how the cat got here. In this blogpost, I try to show what an API is in action, using metaphors from different professions and the definitions I found on the internet. This one goes out for the lawyer, the med, the interpreter and the writer.

Read more
Software Support and Artificial Intelligence - Part 5: Automated proactive support as messages

Technology

Software Support and Artificial Intelligence - Part 5: Automated proactive support as messages

September 16, 2016

Technical writer teams are asked the impossible: chronically understaffed, fulfill growing expectations, while dealing with the disruptions of a barrage of technological innovations. Technology however doesn’t need to be a curse, it could be a blessing: new technologies could also be used to help technical writers. In this series I want explore how artificial intelligence and new/rediscovered interaction models for software documentation could redefine technical writing and its deliverables.

Part 5: Automated proactive support as embedded messages What are our next steps to explore the application of AI in documentation? How can we use a messaging framework to send highly relevant chunks of content to a user?

Read more
Software Support and Artificial Intelligence - Part 4: Repeating Clippy’s mistakes with Walkthroughs

Technology

Software Support and Artificial Intelligence - Part 4: Repeating Clippy’s mistakes with Walkthroughs

August 17, 2016

Technical writer teams are asked the impossible: chronically understaffed, fulfill growing expectations, while dealing with the disruptions of a barrage of technological innovations. Technology however doesn’t need to be a curse, it could be a blessing: new technologies could also be used to help technical writers. In this series I want explore how artificial intelligence and new/rediscovered interaction models for software documentation could redefine technical writing and its deliverables.

Part 4: Repeating Clippy’s mistakes with Walkthroughs
Learning from Clippy’s mistakes. How can we define proactive support? How can we avoid repeating Clippy’s mistakes?

Read more
Software Support and Artificial Intelligence - Part 3: Clippy, misunderstood brilliance before its time

Technology

Software Support and Artificial Intelligence - Part 3: Clippy, misunderstood brilliance before its time

August 11, 2016

Technical writer teams are asked the impossible: chronically understaffed, fulfill growing expectations, while dealing with the disruptions of a barrage of technological innovations. Technology however doesn’t need to be a curse, it could be a blessing: new technologies could also be used to help technical writers. In this series I want explore how artificial intelligence and new/rediscovered interaction models for software documentation could redefine technical writing and its deliverables.

Part 3: Clippy, misunderstood brilliance before its time
Microsoft’s Clippy was a great idea: sometimes it does pay off to give people advice even if they didn’t ask for it yet. So why did it fail?

Read more
Software Support and Artificial Intelligence - Part 2: The Helpful co-worker model

Technology

Software Support and Artificial Intelligence - Part 2: The Helpful co-worker model

August 2, 2016

Technical writer teams are asked the impossible: chronically understaffed, fulfill growing expectations, while dealing with the disruptions of a barrage of technological innovations. Technology however doesn’t need to be a curse, it could be a blessing: new technologies could also be used to help technical writers. In this series I want explore how artificial intelligence and new/rediscovered interaction models for software documentation could redefine technical writing and its deliverables.

Part 2: The Helpful co-worker model Teaching and giving advice is part of human nature. Helpful co-workers as a support services: when are they successful and how do they fail?

Read more
ITrainee program 2016: Towards practicality

MiscellaneousNews & Events

ITrainee program 2016: Towards practicality

August 1, 2016

This year saw the renewal of Pronovix’s ITrainee program, open to university students, recent graduates or those seeking a change or new career. Members of the Pronovix Mentoring lab selected four participants, who were then given the chance to learn about web development and observe the Pronovix workflow environment. Our mentors set up the timeline, defined the goals and established the correlating tasks the participants would be undertaking. We used our experience from the previous programs to establish a workflow with tasks that got the most out of the trainees. There were still some challenges that the mentors did not expect, we discuss them below.

Read more
Software Support and Artificial Intelligence - Part 1: Documentation at a crossroads

Technology

Software Support and Artificial Intelligence - Part 1: Documentation at a crossroads

July 26, 2016

Technical writer teams are asked the impossible: chronically understaffed, fulfill growing expectations, while dealing with the disruptions of a barrage of technological innovations. Technology however doesn’t need to be a curse, it could be a blessing: new technologies could also be used to help technical writers. In this series I want explore how artificial intelligence and new/rediscovered interaction models for software documentation could redefine technical writing and its deliverables.

Part 1: Documentation at a crossroads What jobs do we need documentation to fulfill? Why is documentation under pressure? Why do we need AI in documentation?

Read more
Software support and Artificial Intelligence: a 5 part series

Technology

Software support and Artificial Intelligence: a 5 part series

July 26, 2016

Technical writer teams are asked the impossible: chronically understaffed, fulfill growing expectations, while dealing with the disruptions of a barrage of technological innovations. Technology however doesn’t need to be a curse, it could be a blessing: new technologies could also be used to help technical writers. In this series I want explore how artificial intelligence and new/rediscovered interaction models for software documentation could redefine technical writing and its deliverables.

Read more
Brightcove Video Connect for Drupal 8 - Part 4: Including Videos & Playlists in Drupal content

Technology

Brightcove Video Connect for Drupal 8 - Part 4: Including Videos & Playlists in Drupal content

June 7, 2016

This posts reads as a step-by-step guide for the following tasks:

  • Add Brightcove Video field
  • Browse Brightcove Videos using the Entity Browser module
  • Upload Brightcove Videos inside Drupal content using the Inline Entity Form module
  • Browse and upload Brightcove Videos inside Drupal content from the same field using the Entity Browser IEF submodule
  • Browse and upload Brightcove Videos from CKEditor
Read more