Using Quip in Salesforce

Using Quip for Project Documentation in Salesforce

This is for teams that use Salesforce and Quip, but want to learn how to leverage Quip’s robust features for project documentation. We cover some best practices for creating collaborative project documentation using Quip for Salesforce.

Why use Quip?

You might be wondering why your team should leverage Quip, so before we dive into best practices, let’s look at what the platform has to offer.

Quip is a modern collaboration platform that helps teams work on projects together so they can complete work faster. Living document files, in-line commenting, and real-time chat mean everyone has total project transparency and the most up-to-date information at all times.

While Quip can be used as a standalone platform, it also allows users to integrate with applications like Salesforce and JIRA. Plus, Quip comes with customizable apps that can be added to documents, like a countdown timer and project tracker. Best of all, users can seamlessly switch between desktop and mobile.

Another reason teams love Quip is both Quip and Salesforce are also highly secure platforms. Security is a priority for every organization and meeting security requirements can often be a bottleneck when selecting a project documentation solution. By integrating Quip with Salesforce, teams can trust that all their data and documentation are in one secure location. 

Ready to take a deeper look at Quip for project documentation? Let’s get started.

Salesforce Architecture: Leveraging Quip for Project Documentation

Once Quip has been integrated with Salesforce, a custom Project Documentation object will need to be created in order to leverage Quip for project documentation. Using the Project Documentation object we can tie Cases, Contacts, Quip Documents and Files in one easy location for visibility and reporting. The image above demonstrates what the architecture should look like in Salesforce when setting this up. Here’s a more granular look at how to connect Cases, Files, and Project Members to the Project Documentation object: 

1) Project Documentation: 

  • Use Record Types to share project records immediately with the appropriate teams or Users.
  • Categorize your projects in Salesforce for easily accessible documentation.

2) Cases:

  • Relate Cases to projects in order to show the origin of requests and track end-to-end progress.

3) Files: 

  • The Salesforce Files Component allows you to keep all files and knowledge on the project in one place (including Quip files linked to the Salesforce record).
  • The Salesforce Files Component also makes it much easier to onboard team members to projects because all project information exists in one place and you no longer need to worry about lost files.

4) Project Members:

  • Attach contacts to Project Documentation records
    • Keep track of which users are working on which projects
    • Report on project status and provide insights through dashboards for senior leadership, project managers, etc.

Now that you have an idea of how to integrate Quip with Salesforce for project documentation, let’s take a look at what documents you may find helpful.

What Documents Do You Need?

First, you’ll want to decide which documents are relevant and necessary to include in your Org. 

Requirements Gathering

The requirements gathering process provides an opportunity for Orgs to define how the Salesforce platform will be utilized as well as lead to both a “big picture” view and a detailed view of the necessary documentation. Stakeholders from across the Org should contribute to this process. The good news is that Quip’s functionality enables efficient and seamless collaboration to happen. 

Configuration Workbook (CWB)

If your Org uses multiple record types, profiles, objects and so on, then the Configuration Workbook will become an extraordinarily helpful tool for creating Change Sets and documenting key metadata information in your Salesforce Org. What’s more, Quip’s integration with Salesforce can be used to create a CWB using a custom object “Project Documentation”.

Technical Design

Quip enables users to create robust technical design documentation that contains information like data, objects and fields, workflows, rules, and so forth. Additionally, calendars, project timelines, Live Apps, and in-line commenting can be included in a technical design document created with Quip.

Now that you know what documents you’ll need for project documentation, let’s take a look at a few of the Live Apps you can include in your Quip documents.

Adding Live Apps to Quip Documents

Your team can take project documentation to another level using Quip’s Live Apps. Each app is flexible and customizable, allowing teams to leverage them uniquely for different projects. 

By embedding apps within project documents, all project insights are available in a single view, so everyone stays on the same page throughout the project duration. 

Countdown App

Maintain urgency and reinforce upcoming deadlines using the Countdown app. For example, once you embed the timer in your Quip document, it will keep everyone who is assigned to the project aware of important deadlines, such as a “go live” date.

Countdown App Quip for Salesforce

The Countdown App is a great way to keep your team moving toward important, shared goals.

Project Tracker App

With the Project Tracker app, project milestones can be assigned to one or many users. Then, you can track how the project is progressing in real-time with custom statuses and due dates for each milestone. 

All team members can view who has ownership over various aspects of the project, leading to faster turnarounds and better outcomes. Added benefits include less email and fewer meetings!

In-line Comments

Another useful tool in Quip is in-line commenting. Team members can highlight key points or areas of concern and ask questions, make suggestions, or add other commentary. The In-line Comments feature keeps a record of all conversations and provides an easily auditable history of comments and changes in one convenient document.

Quip inline comments

Now that you’ve had a chance to add some of our favorite Live Apps to your Quip project documentation, let’s take a closer look at integrating Quip with Salesforce.

Using the Quip Document Lightning Component

Salesforce users can also create and work with fully functional Quip documents directly within Salesforce objects and records thanks to the Quip Document Lightning Component.

Simply embed a Quip document on a Lightning page layout and edit it there, too! This process was used to create the easily accessible and digestible project overview pictured below. 

Countdown App Quip for Salesforce

Using this component, you can specify that all Quip documents created from this component follow a specific template, saving you time with future project documentation.

Centralizing your Quip project documentation in Salesforce comes with many benefits, including improved team collaboration, productivity, and a single source of truth. Plus, Quip’s Live Apps provide everyone with real-time insights and help them meet important deadlines.

Document Your Org in Salesforce Using Quip

Earlier in this post, we provided best practices for project documentation using Quip for Salesforce. Now we will explore best practices for Salesforce Admins who want to use Quip to document their Salesforce Orgs.

Why Document Your Org?

Salesforce is an excellent tool that allows for multiple business units, sales processes, and automation to exist in the same place. As your organization grows in size and complexity, knowing exactly how all those components interact becomes more and more important. In fact, sophisticated documentation is an absolute necessity. 

Let’s take a look at three key benefits of documenting your Salesforce Org:

Transfer of Knowledge

Good documentation allows Admins and end-users to easily understand complex functionality and new custom functionality as it’s added to Salesforce. By maintaining centralized documentation on all the projects in your Org, you ensure this knowledge is always transferred and available to every member of your team. 

Line of Sight

With centralized documentation, project managers, Salesforce administrators, and developers can review and access all ongoing projects in a given Org. For example, project managers can review priorities and check on the status of current projects, while Admins and developers can look at past and current projects to determine if there are any dependencies or considerations to examine.

Collaboration 

Finally, documentation enables project members to pool their knowledge and expertise in a single location that is both easily accessible and clearly summarizes its functionality. Not to mention, users can comment in-line on projects and directly notify other users in order to access their knowledge or get approval. With Quip for Org documentation, collaboration is easy!

Quip for Org Documentation

Integrating Quip with Salesforce provides a light-weight, cost-effective solution for companies looking to further improve their Org documentation. 

Now that we’ve covered the benefits of documenting your Org, let’s look at the benefits of leveraging Quip to address this challenge. 

Collaborative Documentation

As we touched on above, using Quip to document your Org facilitates better collaboration, especially because Quip uses “living docs.” Real-time collaborative documentation is vital for a couple of reasons.

Access to Key Stakeholders

It’s imperative that key stakeholders in your Org have insight into the documentation process and can provide direction and feedback. Using Quip for Org documentation makes it easy to solicit input and information from stakeholders across the Org, not to mention receive timely answers to important questions. 

Assigning Tasks & Responsibilities in Salesforce

Just like Quip features enable better collaboration between stakeholders, it also makes assigning tasks and responsibilities in your Org simple and effective. Mentions, alerts, and trackers, for instance, keep documentation up-to-date and on track.

Use the Quip Components Feature

As you document your Org in Salesforce, one of the most useful Quip features you can leverage is the Document Lightning Component. This component lets users work directly in Salesforce objects and records using fully functional Quip documents, spreadsheets, chat rooms, and more.

Best of all, you can take advantage of Quip’s productivity and collaboration features, like in-line comments, mentions, and Live Apps. Quip makes documenting your Org in Salesforce a much easier and more expedient process.

With real-time productivity and collaboration functionality, it’s easy to document your Org in Salesforce using Quip. In addition, Quip and Salesforce are both extremely secure platforms. Security is often a roadblock when selecting a documentation solution; making Quip a great choice for your organization. 

Have more questions about setting up and optimizing Quip project documentation in Salesforce? Reach out today. We love helping Admins make the most of Salesforce.