Topics Map > Documents Tab
Topics Map > General Info

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.

What does the new document edit screen look like, and how is it different from the current edit screen?

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 Overview.

In general, 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).

One key difference is that we have changed the way 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)

These new status labels were applied to the rest of the KB Admin Tools when the new edit screen was released on September 18th. We will be working to update the documentation in the KB User's Guide to match the new terminology.

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, individual authors in your group will be able to choose either the new or classic edit screen when creating new documents or editing existing documents, depending on their preference.

  • Note: Please avoid editing the same document in both editors simultaneously, as changes cannot be synced in real time while both edit screens are open. If you want to switch which edit screen you are using with a particular document, make sure you save your changes and close the edit screen you started with before opening it in the other version.

Beginning on September 18th, the new edit screen is now the default option for document creation and editing. Authors will still be able to access the original edit screen through a secondary option, which is labeled as "classic".

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

Following an initial beta phase where groups had the option to opt in, the new edit screen was broadly released to all groups. At this time, all groups have access to the new edit screen (still alongside the current edit screen).

Eventually, the "classic" edit screen will be retired. 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 click on the "Feedback" link at the bottom of the right side panel in the new edit screen to access 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.

Will the edit screen for "News" be changing?

Not yet—the settings and workflow for news items are very different from documents, so this will be addressed in a later stage.



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