In zoom keybase kept images from manual#

This helps keep the focus on what’s being explained. To strike the perfect balance, our custom diagrams are based heavily on the existing UI, but unrelated parts of the UI are intentionally abstract or low fidelity. Screenshots were considered, but they would need updating as the UI evolves, and the extra detail would add to the reader’s cognitive load. Diagrams help clarify key concepts, and Mary Poppins adds a bit of fun. Some of the concepts of Keybase are a little different than other apps-for example, passwords aren’t necessary-so we created custom diagrams to help ensure key concepts were as clear as possible.ĭiagrams also make the content more scannable and contribute to a gentle pace by breaking it up into smaller sections. But for now, beginning with clear, accessible information makes it easier for everyone-non-technical and technical folks alike-to understand and use Keybase. Remembering the content mission and guidelines will help keep new additions useful. Because Keybase Book is open source, anyone can contribute new writing, questions, or ideas to help clarify information.

While all of our work was informed by the feedback and user data we had, our hope is that Keybase Book will continue to respond to user needs and become even more useful over time. Following these guidelines helped ensure that what we wrote would be clear and useful to a broad range of non-technical and technical users. When we had to present more complex info, we broke it down into short sentences and lists. We only shared technical details if they were necessary. For example: if we introduced a technical term, we had to define it. This helped us create some other guidelines.

Technical early adopters who understand public-key cryptography but may not understand how easy Keybase makes it for everyone.įurther, Keybase Book should show how Keybase can be used for all of your tasks online, with all of the people you interact with, easily and more safely and securely than anywhere else.Įverything we put in Keybase Book had to support this mission.

Non-technical folks who rely on the internet to get things done and are concerned about security and privacy, and.

To write and organize useful and usable documentation, we established a mission for our content: to help Keybase gain more users by sharing information about how it works and why it’s so powerful for: Chris Coyne, Cofounder of Keybase Information that’s accessible to everyone Faculty’s talent and care for their work delivered excellent results on all aspects of our project-from content creation to user experience design and web development. And it supports Keybase’s long-term goals: the site is fast, easy to use and update, and affordable to maintain. It reflects the spirit of Keybase: intelligent and fun. It helps people understand why Keybase works the way it does-proactively addressing common questions, concerns, and misconceptions-so that everyone feels safe and smart using it. Keybase Book is a comprehensive guide for anyone using the app. Fortunately, Faculty is a small but mighty team with the skills to cover the content, design, and development. It was also important to the Keybase team that we make it, like Keybase itself, open source. Our goal was to succinctly and concretely explain the uses and benefits of Keybase on one beautiful, responsive, easy-to-navigate, and fast site. And because the content lived in multiple places, it wasn’t easy for people to find answers to their questions.

While much of it was engaging, it was really only useful for more technical users.

In zoom keybase kept images from manual#

Since the beginning of the company in 2014, the Keybase team had been creating their own documentation-both a technical manual for advanced users, and blog posts intended for a wider audience. They trusted Faculty to design and build a brand-new documentation site-and write new documentation-to help make Keybase accessible to more people. And they knew they needed to work with a team that understood both the technical details and the needs of non-technical users to better show folks what Keybase is all about. Not understanding why and how was preventing more people from understanding the value of Keybase, which was ultimately preventing them from using it. The public-key cryptography that powers Keybase makes the app work a little differently than other apps.

Everyone should use it-for chat messaging, file sharing, team collaboration, and more-but not everyone does. Keybase is a secure, end-to-end encrypted app for everything you do online. They provided clarity, expertise, and outstanding outcomes. Faculty helped us identify and address a big opportunity to better serve our customers.