Improved linking experience

[Witoso]

Note

This initiative is connected to the Bookmarks work.

Goal

Our main goal is to allow users to easily link to the bookmarks created in the document. But we are aware that the linking interface is one of the most used, and it would be good to redesign it thinking also about other (future) use cases.

Description

Linking experience is the core of the editor. It's important to remember linking to bookmarks is just one use case in the whole context of linking.

When we think about linking, there are a couple of actions that could the user do in modern systems:

• I can add/edit a link.
  • By hand,
  • By selecting from a list,
  • By searching some repository of links.
• I can add/edit the text of the link.
• I can configure the link (what we call decorators).

We decided to spend some time, iterate on the current link UI, and cover most of the use cases above. Check the prototypes below.

Prototypes

Linking

Nagranie.z.ekranu.2024-10-3.o.08.52.54.mov

Bookmarks

Nagranie.z.ekranu.2024-10-3.o.08.51.52.mov

Decorators

Screen.Recording.2024-10-07.at.11.52.06.mov

Scope

We are still defining the final scope, for now, the main directions of development for us are:

• Refreshing the UI, adding the possibility to add/edit text.
• Moving decorators to a separate subpage.
  • This gives a space for more advanced inputs in the future (select, text input).
• Providing a Bookmarks list. We are considering a possibility for integrators to define their own lists.

We don’t plan to provide the search of links feature yet. This would have a large scope to cover, and making accessible search is non-trivial. But we definitely consider this in the future.

We are also aware that there are some integrators override/extend the link UI. We will try to figure out what to do with it, and implement minimal breaking changes if possible.