Skip to content

Latest commit

 

History

History
46 lines (32 loc) · 1.64 KB

commits.md

File metadata and controls

46 lines (32 loc) · 1.64 KB
layout
title description tableOfContents outline pagination
visible
true
visible
visible
true
visible
true
visible
true

Commit messages & Autolink

By default, when exporting content from GitBook to the Git repository, GitBook will generate a commit message based on the merged change request:

GITBOOK-14: Improve documentation about users management

Autolink GITBOOK-<num> in GitHub and GitLab

If you want to automatically resolve your GitBook change request IDs (e.g. GITBOOK-123) in commits to links, you can enable this using GitHub’s Autolink references feature. See instructions on GitHub.

Use the following URL format, where spaceId corresponds to your space’s URL:

<https://app.gitbook.com/s/{spaceId}/~/changes/<num>/

Autolink setup.

Customize the commit message template

When using GitBook with a monorepo, or when you have specific guidelines for commit messages; you might want to customize the message used by GitBook when pushing a commit to Git.

The template can contain the following placeholders:

  • {change_request_number} unique numeric ID for the change request
  • {change_request_subject} the subject of the change request when merged, or No subject if none has been provided.

The default template is:

GITBOOK-{change_request_number}: {change_request_subject}