KB User's Guide - Document Edit Screen Transition FAQ

This document answers some common questions about the transition to the new document editing interface in the KB Admin Tools.

Why did you decide to design a new document edit screen?

Because the majority of the work KB users perform is centered around the creation and updating of documents, it made sense to focus our efforts in this area of the application.

Additionally, user research that we have conducted over the years has shown that the document edit screen routinely comes up when discussing pain points. Of these, we particularly wanted to address the following challenges:

  • New authors find the number of settings overwhelming and are often unsure of which settings are necessary
  • Authors with a variety of experience levels struggle to find settings that they don't frequently use
  • Options to manage document status can be confusing, and authors sometimes unintentionally select the wrong option (for example, save changes to the draft version when they intended to publish them)

Our hope is that the new edit screen helps improve your experience when editing documents, especially as it relates to the items above.

How is the new document edit screen different from the current edit screen?

All of the functionality available in the current edit screen can also be found in the new edit screen. However, many features have been moved around and re-grouped, and some have been renamed (and a few new features have been added).

In particular, you will notice that we have changed the way that we refer to document statuses. The new screen uses the following status labels, which relate to the same statuses you have always used:

  • Save draft (In progress)
  • Publish (Active)
  • Submit for review (In review)
  • Archive (Inactive)
  • Move to trash (Delete)

Eventually, these new status labels will be applied to the rest of the KB Admin Tools, but this will come later (after the current edit screen is retired).

For a detailed overview of the new edit screen, including the location of all document tools and settings, please see KB User's Guide - Document Edit Screen (Beta) Overview.

How do I test out the new (beta) document edit screen?

If desired, your group can opt in as a early adopter of the new document edit screen by following the steps described here: KB User's Guide - Enabling the Beta Document Edit Screen.

Please note that since the new editor is still in "beta", we may make further changes depending on what feedback we receive. We expect that most changes will be relatively small in scope, and we will notify early adopters if more extensive changes are found to be necessary.

Groups that do not choose to participate in the early adoption phase will get access later on when we move to a broader release (see the timeline information below).

Will authors in my group retain access to the current edit screen?

Yes. Enabling the new edit screen at this stage will not remove the current edit screen. Instead, you will have the option to create new documents or edit documents in one or the other. You can also switch back and forth if needed. The only thing you should avoid is editing the same document in both editors simultaneously, as changes cannot be synced in real time while both edit screens are open.

What does the timeline for transitioning to the new edit screen look like?

Currently, our plan is to allow groups to opt in as early adopters, and those groups will not lose access unless they opt out again during this phase. During this phase, we will be collecting feedback and working to address any reported problems as needed.

Once we believe the beta version of the new edit screen is stable, we will move into a broad release phase. In this phase, all groups will have access to the new edit screen (still alongside the current edit screen).

At this point, we will base our decision to retire the current edit screen on the following:

  • Any outstanding issues have been addressed
  • Use of the new editor is outpacing use of the current editor

We will notify all users via an alert in the KB Admin Tools once we have a date set for the retirement of the current edit screen.

How do I submit feedback on the new edit screen?

For general feedback (either positive or negative), you can fill out our feedback form. You will have the option to submit the form anonymously or provide your email address for potential follow-up from our team.

If you encounter a problem with the new edit screen, for example, if something does not appear to be working correctly, please submit a support ticket by emailing kb-team@doit.wisc.edu. This will allow us to troubleshoot the issue with you in more detail.



Keywords:
frequently asked questions editing interface changes new beta ui timeline implementation early adopters adoption transition retirement
Doc ID:
152383
Owned by:
Leah S. in KB User's Guide
Created:
2025-06-25
Updated:
2025-06-26
Sites:
KB User's Guide