Blog Post

Annotation Replies and Reviews

Illustration: Annotation Replies and Reviews

The PDF standard allows documents to contain embedded discussions, thereby facilitating a wide range of document workflows. Today we’re delighted to bring full support for embedded discussions to mobile in PSPDFKit 7.5 for iOS, PSPDFKit 2.5 for macOS and PSPDFKit 4.5 for Android.

Reviewing PDF Documents

Many PDF viewers can display single notes or comments in a document, but this is a messy format for conversation. For example, if a copy editor leaves a comment on a particular paragraph, there’s no easy way for the author to respond to it in place. With multiple comments scattered across the page, it quickly becomes near impossible to piece together the flow of conversation — something which is not at all conducive to discussion and quality output.

An option for people who don’t want to deal with the above is to have an exchange take place in a different channel, such as email. However, this can quickly become convoluted and chaotic; you’ll either need to keep quoting bits of text to be clear what’s being talked about, or else you’ll need to be hyperspecific, e.g. “the third paragraph after the big diagram on page six doesn’t make sense.”

Replies in PSPDFKit

Replies within a PDF make having a thoughtful conversation directly in the context of the document under review a straightforward process. Anyone can keep up with the flow of conversation and see exactly which detail in the document is being discussed.

PSPDFKit’s new built-in support allows for exactly this: Users can view, search, and add comments to a discussion in a document with a vibrant, modern user interface. Bringing this to mobile means everyone can have their say, regardless of where they are and what device they’re using.

The UI has been designed to perfectly blend into iOS:

On Android, we use a Material-design style dialog:

And because you often don’t have time to type lengthy responses on the go, the review feature makes it easy to give feedback. Users can leave simple review states on any comment: accepted, completed, cancelled, or rejected.

iOS Set Status Menu
Android Set Status Menu

With a simple tap, you can quickly see the names of everyone who left a review.

iOS Expanded Review Summary
Android Expanded Review Summary

Technical Details

PSPDFKit also provides a low-level API for programmatic access to the properties stored in the PDF, enabling you to build custom solutions on top of replies and reviews. PSPDFKit implements annotation replies and reviews conforming to the PDF specification and is fully compatible with the same features in Adobe Acrobat.

You can read more about these details in our Annotation Replies and Reviews guides for iOS and Android.

To see of all the features, improvements, and changes in detail, check out our iOS and Android changelogs.

Author
Douglas Hill iOS Team Lead

Douglas makes the most of our fully remote setup by frequently traveling around Europe by train. He’s a proponent of iPad as a productivity platform and is obsessive about the details of great user experiences. He’s also an organizer of the NSLondon meetup.

Explore related topics

Share post
Free trial Ready to get started?
Free trial