24 January 23: New comments UI, improved diff view, and more

We've spent a lot of time fixing critical bugs, improving performance, and adding key features.

🎉 New

Improved Comments UI

We've looked into the way comments are being used across GitBook, and have made some major improvements not only to the way they function, but also to the way they allow you to work with the rest of your team. Here's a quick summary of some of the major changes:

• Comments moved to sidebar instead of overlay

• Context added to block level comments

• Comments available in diff mode

Updated diff view & indicators

We've also made some major UX improvements to the way diff view looks and feels, allowing you to have greater context to the the things that have changed inside a document you might be working on.

• Deleted blocks now show a diff indicator in the editor

• Apply new diff view UI elements in diff mode

• Added modified/added diff indicators when viewing a change request

OpenAPI request body examples added

If you're using the OpenAPI block in any of your GitBook pages, you'll now see any request body examples included in the definition file used to generate the block.

Create board

Creates a board with the specified name and sharing policies.Required scope <a target=_blank href=https://developers.miro.com/reference/scopes>boards:write Rate limiting <a target=_blank href=https://developers.miro.com/reference/ratelimiting>Level 3

POSThttps://api.miro.com//v2/boards

Body

application/json

descriptionstring

Description of the board.

namestring

Name for the board.

policyBoardPolicyChange (object)

Defines the permissions policies and sharing policies for the board. For more information, see Permissions policy.

teamIdstring

Unique identifier (ID) of the team where the board must be placed.

Response

201400404429

Board created

Body

application/json

id*string

Unique identifier (ID) of the board.

Example: "uXjVOD6LSME="

name*string

Name of the board.

Example: "Sample board name"

description*string

Description of the board.

Example: "Sample board description"

teamTeam (object)

picturePicture (object)

Team picture

policyBoardPolicy (object)

Defines the permissions policies and sharing policies for the board. For more information, see Permissions policy.

viewLinkstring

URL to view the board.

Example: "https://miro.com/app/board/uXjVOD6LSME="

ownerUserInfoShort (object)

Contains information about the user who owns the board.

currentUserMembershipBoardMember (object)

Contains the current user's board membership details. The current user could be different from the board owner.

createdAtstring (date-time)

Date and time when the board was created. Format: UTC, adheres to ISO 8601, includes a trailing Z offset.

createdByUserInfoShort (object)

Contains information about the user who owns the board.

modifiedAtstring (date-time)

Date and time when the board was last modified. Format: UTC, adheres to ISO 8601, includes a trailing Z offset.

modifiedByUserInfoShort (object)

Contains information about the user who owns the board.

linksBoardLinks (object)

Contains applicable links for the board.

type*string

Type of the object that is returned. In this case, type returns board.

Example: "board"

Request

JavaScriptCurlPython

const response = await fetch('https://api.miro.com//v2/boards', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

201400404429

{
  "id": "uXjVOD6LSME=",
  "name": "Sample board name",
  "description": "Sample board description",
  "team": {
    "id": 3074457345618265000,
    "name": "Dev Team",
    "picture": {
      "id": 3074457345618261500,
      "imageURL": "https://miro.images/5252525252/125252/266/144/1/size210.jpg",
      "originalUrl": "https://miro.com/original-image.jpg",
      "type": "text"
    },
    "type": "text"
  },
  "picture": {
    "id": 3074457345618261500,
    "imageURL": "https://miro.images/5252525252/125252/266/144/1/size210.jpg",
    "originalUrl": "https://miro.com/original-image.jpg",
    "type": "text"
  },
  "policy": {
    "permissionsPolicy": {
      "collaborationToolsStartAccess": "all_editors",
      "copyAccess": "anyone",
      "sharingAccess": "team_members_with_editing_rights"
    },
    "sharingPolicy": {
      "access": "private",
      "inviteToAccountAndBoardLinkAccess": "viewer",
      "organizationAccess": "private",
      "teamAccess": "private"
    }
  },
  "viewLink": "https://miro.com/app/board/uXjVOD6LSME=",
  "owner": {
    "id": 3074457353169356300,
    "name": "John Smith",
    "type": "user"
  },
  "currentUserMembership": {
    "id": 3074457353169356300,
    "name": "John Smith",
    "role": "viewer",
    "type": "board_member"
  },
  "createdAt": "2024-11-17T18:44:23.245Z",
  "createdBy": {
    "id": 3074457353169356300,
    "name": "John Smith",
    "type": "user"
  },
  "modifiedAt": "2024-11-17T18:44:23.245Z",
  "modifiedBy": {
    "id": 3074457353169356300,
    "name": "John Smith",
    "type": "user"
  },
  "links": {
    "related": "http://api.miro.com/v2/boards/o9J_k1JKioQ=/members?limit=20&offset=0",
    "self": "http://api.miro.com/v2/boards/o9J_k1JKioQ="
  },
  "type": "board"
}

Notifications are now sent for all space reviewers for change requests

Lastly, we've improved the way notifications are shared when change requests are finished and submitted for review.

➕ Improved

We've also made improvements to the following:

• Add missing icons to table options menus.

• Add support for (un)indenting multiple selected list items.

• Add an option to show/hide the pagination at the bottom of the page.

• Directly download a file in a table when clicking it on public content.

• Add a back button to the change request header breadcrumb.

• Improve table UX when editing column options and header titles. They now auto-save on change.

• Improve keyboard navigation in table cards, using Backspace and Enter to move between having the entire card selected or a specific column.

• Change the default state of new created checklist items to unchecked.

• Change the default extension for drawing files to .excalidraw.svg to ease the insertion of drawing created in excalidraw.com.

🔧 Fixed

Below is a list of bug fixes also included in this release:

• Limit collection description input to prevent silent "Missing or insufficient permission error".

• Fix outline active section compute on public content.

• Fix popovers placement on public content.

• Fix hovering annotations leading to text wavering.

• Fix tab navigation within table cells and non-text cells selection.

• Fix caching Firestore queries in browser cache to improve initial load time.

• Fix page shift when switching between editable and diff views.

• Fix an issue where the collection dropdown wouldn't show if the page is scrolled.

• Fix an issue where selecting heading text was not possible.

• Fix keyboard selection of Inline math nodes.

• Fix the expandable block collapsing when editing the title.

• Fix images being rendered very small on mobile.

• Fix issue where scrolling position is lost when switching to diff or creating a Change Request.

• Fix vertical content shift in diff mode.

• Fix an issue where only selected image, from multiple, would open in gallery

• Fix issue where Space or Collection invite links are not deleted when content is moved to new owner.

• Fix issue where last image in a carousel is slightly bigger.

We're constantly working on improving the way you and your team work in GitBook, and value your input on features, bugs, and more. Make sure you head to our official GitBook Community to join the discussion.