Artificial Intelligence Authors: Elizabeth White, Yeshim Deniz, Zakia Bouachraoui, Liz McMillan, William Schmarzo

Blog Post

Technical Document Review

PeerReview Complete 2012 at IBM Innovate 2012

There are essentially three ways to enable document review:

  • Inspection meetings
  • Multiple document copies distributed via email
  • Serial review enabled by document management systems

Although some organizations have a strict discipline around peer review that includes high-ceremony inspection meetings, most use document-authoring tool features for commenting and annotating documents.  Those users who rely on Microsoft Word to write technical documents know that it's not really a review tool; when authors email the document to their colleagues for review:

  • Reviewers can't see each other's comments
  • Emails cross, causing confusing overlapping threads
  • Authors have to assess and merge each reviewer's feedback by going through each marked-up document

Alternatively, when everyone reviews the same document checked into a repository, as with document management systems, other issues arise:

  • Only one person can review the document at a time
  • The new review cannot begin until the prior review is complete
  • Serial review lengthens the review process

A further fly in the ointment is that, in these cases, metrics are not collected, there is no automated issue tracking or sign-off by key stakeholders, and there is a complete absence of any meaningful interaction among the reviewers unless they all gather in a review meeting (which developers hate.)

Clearly, these processes are flawed.

With PeerReview Complete Document Review Will Never Be the Same

Now, the same leading-edge techniques that software developers use to perform code review are available to members of the broader project development team. Based on SmartBear’s highly-acclaimed collaborative code review techniques that eliminated much of the tedium involved in peer code reviews, PeerReview Complete gives teams the tools they need to do reviews in the most efficient way possible. Reviewers can:

  • Comment on the same, centrally-managed, always-current version
  • Use threaded contextual chats and view other’s comments in real-time
  • Review comments easily since comments are anchored to text and maintain their context even when information is added, deleted or moved
  • Find, flag and track defects through resolution
  • Eliminate crossed emails and maintain comment threads in one place
  • Review artifacts simultaneously or asynchronously, by bringing distributed teams into the review process—without meetings

Reviewers annotate and comment on documents in parallel (click here for full image)

IBM Innovate 2012

SmartBear will demonstrate a preview of these upcoming features (as well as the new electronic signature capability) in PeerReview Complete at IBM Software Innovate 2012 in booth 413. The event runs through June 7 in Orlando, Fla. Visitors to the booth that are interested in participating in our Beta program should ask for John Lockhart, the Product Manager for SmartBear’s Peer Review Products.

Watch a video overview of PeerReview Complete with IBM Rational Team Concert (RTC) below.

More Stories By Alex Forbes

Alex Forbes is a B2B software marketing leader with experience in analyst relations, content marketing and product marketing. He follows the IoT, rapid application development, and cloud markets to help customers improve their digital transformation initiatives, customers' buyer journeys and experience from both an IT and business perspective.

IoT & Smart Cities Stories
Intel is an American multinational corporation and technology company headquartered in Santa Clara, California, in the Silicon Valley. It is the world's second largest and second highest valued semiconductor chip maker based on revenue after being overtaken by Samsung, and is the inventor of the x86 series of microprocessors, the processors found in most personal computers (PCs). Intel supplies processors for computer system manufacturers such as Apple, Lenovo, HP, and Dell. Intel also manufactu...
At CloudEXPO Silicon Valley, June 24-26, 2019, Digital Transformation (DX) is a major focus with expanded DevOpsSUMMIT and FinTechEXPO programs within the DXWorldEXPO agenda. Successful transformation requires a laser focus on being data-driven and on using all the tools available that enable transformation if they plan to survive over the long term. A total of 88% of Fortune 500 companies from a generation ago are now out of business. Only 12% still survive. Similar percentages are found throug...
Darktrace is the world's leading AI company for cyber security. Created by mathematicians from the University of Cambridge, Darktrace's Enterprise Immune System is the first non-consumer application of machine learning to work at scale, across all network types, from physical, virtualized, and cloud, through to IoT and industrial control systems. Installed as a self-configuring cyber defense platform, Darktrace continuously learns what is ‘normal' for all devices and users, updating its understa...
AI and machine learning disruption for Enterprises started happening in the areas such as IT operations management (ITOPs) and Cloud management and SaaS apps. In 2019 CIOs will see disruptive solutions for Cloud & Devops, AI/ML driven IT Ops and Cloud Ops. Customers want AI-driven multi-cloud operations for monitoring, detection, prevention of disruptions. Disruptions cause revenue loss, unhappy users, impacts brand reputation etc.
Apptio fuels digital business transformation. Technology leaders use Apptio's machine learning to analyze and plan their technology spend so they can invest in products that increase the speed of business and deliver innovation. With Apptio, they translate raw costs, utilization, and billing data into business-centric views that help their organization optimize spending, plan strategically, and drive digital strategy that funds growth of the business. Technology leaders can gather instant recomm...
OpsRamp is an enterprise IT operation platform provided by US-based OpsRamp, Inc. It provides SaaS services through support for increasingly complex cloud and hybrid computing environments from system operation to service management. The OpsRamp platform is a SaaS-based, multi-tenant solution that enables enterprise IT organizations and cloud service providers like JBS the flexibility and control they need to manage and monitor today's hybrid, multi-cloud infrastructure, applications, and wor...
The Master of Science in Artificial Intelligence (MSAI) provides a comprehensive framework of theory and practice in the emerging field of AI. The program delivers the foundational knowledge needed to explore both key contextual areas and complex technical applications of AI systems. Curriculum incorporates elements of data science, robotics, and machine learning-enabling you to pursue a holistic and interdisciplinary course of study while preparing for a position in AI research, operations, ...
After years of investments and acquisitions, CloudBlue was created with the goal of building the world's only hyperscale digital platform with an increasingly infinite ecosystem and proven go-to-market services. The result? An unmatched platform that helps customers streamline cloud operations, save time and money, and revolutionize their businesses overnight. Today, the platform operates in more than 45 countries and powers more than 200 of the world's largest cloud marketplaces, managing mo...
I spend a lot of time helping organizations to “think like a data scientist.” My book “Big Data MBA: Driving Business Strategies with Data Science” has several chapters devoted to helping business leaders to embrace the power of data scientist thinking. My Big Data MBA class at the University of San Francisco School of Management focuses on teaching tomorrow’s business executives the power of analytics and data science to optimize key business processes, uncover new monetization opportunities an...
Trend Micro Incorporated, a global leader in cybersecurity solutions, helps to make the world safe for exchanging digital information. Our innovative solutions for consumers, businesses, and governments provide layered security for data centers, cloud workloads, networks, and endpoints. All our products work together to seamlessly share threat intelligence and provide a connected threat defense with centralized visibility and investigation, enabling better, faster protection. With more than 6,00...