Basic video production for developers

A director's chair with developer written on it, lighting and a clapperboard, introducing filmmaking for developers.
April 29, 2020


In my role at Contentful, I create and deliver online instructional materials for our customers. These learning materials take on a variety of formats, but my main focus is creating instructional videos. When I was invited to speak at Dreamstacks about filmmaking for developers, I was confident about the topic but worried about the audience. Dreamstacks is a meetup for developers, hosted by Contentful and Algolia. Why would developers care about filmmaking? Will they even listen to a non-developer like me? Would I be wasting their time?

But the more I thought about it, the more I realized that developers are just like filmmakers and coding is a language like filmmaking is. It’s important to understand how to use that language to communicate effectively in both cases. With this realization, I used my presentation to help developers use filmmaking techniques to educate, promote and inspire others. 

With many of us sheltering-in-place during Covid-19, it’s even more crucial for developers to understand how to use one of the most readily available formats — video — to get their ideas across in succinct and compelling ways. In this blog post, I walk through some of the most important points of that presentation. 

Heads up — I tend to use the terms “video” and “film” interchangeably. Generally, I’ll use video when referring to a specific project and filmmaking when I’m talking about the art form.

Filmmaking is a process

Since a lot of us watch films, we think we know what it takes to make a film. The reality, however, is that a lot of people who are new to filmmaking underestimate the amount of time, effort, and resources it takes to make even a simple video.

To make it easier, it’s helpful to break down filmmaking into three stages:

  1. Pre-production

  2. Production

  3. Post-production

Regardless of what kind of video you’re planning on creating, I recommend following this process to help keep yourself organized, on track, and sane.

Pre-production: the most important part of filmmaking

I’m not exaggerating when I say that this stage of the process is the most important for any video project. When you take the time to plan out as much as you can in the beginning, it will save you time in the long run, especially during shooting and editing.

Choosing storytelling structures

In feature films, we tend to see a wide variety of storytelling structures. From multi-perspective narratives to time-bending plots, feature films have the luxury of time and high audience buy-in to get experimental. As developers, you are generally going to have less time and less audience buy-in. As a result, you have to be especially astute in the way you structure your story to capture your audience’s attention. 

Here are some storytelling structures that I think are most useful for you as developers:

  • Screen demo: A video that demonstrates how to use a software, platform, or product. Basically a tutorial. This usually consists of a screen recording with voice-over. As a developer, you are probably most familiar with this structure.

  • Explainer: A video that is trying to explain a single concept or idea. They are usually very short and can take on many different formats (live action, animation, whiteboard, etc.)

  • Case study: A video that highlights how an organization or customer tackles a business problem or challenge. Generally structured as a short documentary with A-roll and B-roll footage. A-roll is your interview footage; B-roll is everything else (shots around the office, still photos, diagrams).

  • Narrative: A fictional video that is highly scripted and might follow a traditional three-act structure. In the B2B or B2C world, these work best as marketing videos or commercials.

Next time you are about to make a short video, think about how these different storytelling structures might apply to your project or how they might be combined. For example, combining a case study with a screen demo can result in a very compelling story, where you present a customer problem and then show the solution via your product or platform. 

While you’re thinking about structure, you might also want to think about length. The video-hosting company Wistia conducted a study on 564,710 videos and 1.3 billion plays and found that videos up to two minutes in length were best able to maintain audience engagement. After two minutes, engagement declines rapidly. 

Tips on scripting

If there was one step of the pre-production process that I would designate as mandatory, it would be this one. Without a script, you have no plan. 

While you can use whatever format works for you, I recommend using a simple side-by-side format for your scripts. In this type of script, you create two columns: one for all of your video/graphics/animations and one for all the audio. Remember, when you are writing for film, you are not writing a novel. Don’t worry about writing beautiful prose or creating flowery exposition. Focus on everything the viewer will either see or hear. 

An image of an example script

How to storyboard

A storyboard is a scene-by-scene or, sometimes, shot-by-shot visual representation of your film. Don’t worry if you are not a great artist. It’s not about drawing ability; it’s about ensuring that you will get the shots you need for editing — a technique called “coverage” in filmmaking. 

Example storyboard from the film "There Will be Blood"

Example storyboard from the film There Will Be Blood from the Directors Guild of America.

Creating a storyboard also serves another important purpose: it encourages you to start thinking about composition. In film, composition refers to the design and arrangement of elements for each shot. When thinking about composition, pay attention to shot sizes, angles, symmetry, lines, camera motion, framing, and perspective. For example, let’s pretend you are shooting an interview. Are you going to shoot that interview in a wide shot or close up or a mix of both? Are you going to choose to shoot at a straight-on angle or slightly from above or below? How are you going to frame your subject? Each composition choice you make will elicit a different emotional response from your audience.


There’s a lot of other preparation that often happens in this stage. Depending on the size and scope of your project, you may need to: 

  • Finalize the budget

  • Scout locations

  • Audition and hire talent 

  • Hire crew

  • Screen test/rehearse

  • Create schedules (call sheets)

Production, when filming begins

This is the stage where all the fun begins. You’ve done all of your planning and now you can finally start recording and shooting!

How to start screen recording

At some point as developers you’ve probably recorded your screen. We often discuss the software designed for this task (Camtasia, Snagit, Quicktime, Screenflow) but we seldom discuss the best practices. At the very least, I recommend the following:

  • Match the resolution settings. For the best quality, you should record your screen, edit your project, and export your project all at the same resolution — ideally 1080 x 1920.

  • Cut out unnecessary parts of the screen. This includes your browser tabs, bookmarks, and desktop.

  • Leave a few seconds cushion at the beginning and end when you are recording. This will help you when you are editing different clips of your screen together or when you need to record a longer piece of narration.

  • It’s hard to record your screen and your voice perfectly in one take. I recommend you make a rough recording of your voice over when you are recording your screen to get the timing right. Then, redo that voice-over later in your video editing software as you are watching your screen recording. 

What equipment you’ll need 

It’s tempting to get sucked into a black hole of googling cameras, microphones, lights, and so on. While it’s important to scope out your needs and research equipment, there is no such thing as the perfect video kit. There are always going to be tradeoffs, and that's okay. Having a solid story and plan will always eclipse having the latest gear. Start with a camera and a simple shotgun mic and then add on accessories as you grow your expertise.

I’m not going to recommend a list of equipment because each person’s budget and needs are going to vary. Instead, I will provide you with my top three tips that I’ve picked up over many years of having to purchase equipment for different organizations and companies:

  1. Carefully weigh the tradeoffs between different types of cameras you can use for video. Some of the most popular types of cameras for video include DSLR, mirrorless, prosumer, and cinema cameras. They all have their pros and cons (weight, interchangeable lenses, capture formats, resolution, price, etc.) and what you end up with depends on your individual priorities. 

  2. Invest in audio. If you are planning on purchasing a camera, find one that has mic inputs. This will allow you to use external microphones with your camera, which are infinitely better than any audio you’ll ever get out of the internal microphones. If your camera has a 3.5mm stereo jack, you can buy a simple camera-mounted shotgun mic. If you are lucky enough to have a camera with XLR audio inputs or an XLR adaptor, you can choose from a variety of professional microphones. If you have more money and expertise, consider an external audio recorder that will allow you to record independently from your camera and sync up the audio and video later in post-production.

  3. Buy a good video tripod that can not only support your camera, but also gives you smooth tilting and panning motions. This is a simple and relatively cheap way to make your videos look more professional. 

How to create a set up

There are a lot of different camera and lighting setups in film, but the one you will probably rely on most as a new filmmaker is the three-point lighting setup, which is often used to light subjects during interviews or presentations. The three point-lighting setup relies on three sources of light: a key light which serves as your main source of light, a fill light which softens shadows, and a rim light (aka as back light) which serves to separate your subject from the background. 

An example of how three point lighting is set up

It’s great if you have three lights, but you can pull off this same lighting setup with fewer lights. For example, if you only have two lights, you can use natural light through a sheer curtained window as your fill light. You can also work wonders with a reflector (or piece of foamcore) to light a scene.

Post-production: finalizing the video

This is the stage of the process that is probably the most tedious but also the most rewarding. This is where you finally get to see all of your planning and hard work come together. 

How to prepare for post-production 

While it can be very painstaking, transcribing and logging (making note of timecodes) your footage can help you uncover the best “takes” and soundbytes, saving you from digging through footage when you’re actually editing. 

You will also want to gather all of your media assets before you begin editing. This includes motion graphics, logos, lower thirds, archival footage, photos, diagrams, and so on. Don’t forget about music and sound effects. Are you going to license a piece of music or make your own? Finding the perfect piece of music that strikes the right tone and emotion can be surprisingly time consuming and difficult. 

How to get started with editing

Good editing is editing that you don’t notice. It should flow seamlessly together and never feel jarring (unless, for some reason, you are going for that effect). To edit your video, you can use something as simple as iMovie or as advanced as Adobe Premiere. 

  • Explore different types of cuts. Many people don’t realize when they are watching a film how many different types of “cuts” they are seeing. Professional film editors employ a number of different “cuts” to stitch shots together: standard cuts, match cuts, L-cuts, J-cuts, jump cuts, etc. 

  • Avoid cheesy transitions, graphics, or titles. While these effects seem fun at first (iMovie’s Star Wars crawl, anyone?), they grow tiresome when you see the same effects over and over again. Even worse, they tend to make your videos look like school projects.

  • Use subtle animation on screen demos of platforms, products, or apps. When you are talking about buttons, dropdown menus, tabs, or other tiny features of your interface, it helps to zoom in on those details for your audience. On the flip side, don’t stay zoomed in the whole time. Zoom back out when you need to reorient your audience or when you need to move to different screens.

  • Leverage music and sound effects. Audio can be an especially powerful medium. You can use music or sound effects to emphasize specific moments of your video or to spark particular emotions. Be wary of cutting your video too closely to the music; you don’t want your project to turn into a music video.

That’s a wrap: Basic video production for developers

I know this post covers a lot, but don’t get overwhelmed. Filmmaking is a complicated art form that requires both strong visual and aural senses. Focus your energy on perfecting your story or idea — that’s how you will connect with your audience. You can always grow your technical skills over time as you naturally ramp up the complexity of your projects. 

As a budding filmmaker, you’re juggling a lot — from screenwriting to audio mixing to art direction. Make mistakes, forgive yourself, and continue learning. Remember, you are building a new skill set that is incredibly important, now more than ever.

About the author

Don't miss the latest

Get updates in your inbox
Discover how to build better digital experiences with Contentful.
add-circle arrow-right remove style-two-pin-marker subtract-circle remove