Skip to content

GitLab Next

    • GitLab: the DevOps platform
    • Explore GitLab
    • Install GitLab
    • How GitLab compares
    • Get started
    • GitLab docs
    • GitLab Learn
  • Pricing
  • Talk to an expert
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
    • Menu
    Projects Groups Snippets
  • Get a free trial
  • Sign up
  • Login
  • Sign in / Register
  • GitLab Docs GitLab Docs
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Locked Files
  • Issues 164
    • Issues 164
    • List
    • Boards
    • Service Desk
    • Milestones
    • Iterations
  • Merge requests 11
    • Merge requests 11
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
    • Test Cases
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Packages & Registries
    • Packages & Registries
    • Container Registry
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Code review
    • Insights
    • Issue
    • Repository
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar

GitLab 15.0 is launching on May 22! This version brings many exciting improvements, but also removes deprecated features and introduces breaking changes that may impact your workflow. To see what is being deprecated and removed, please visit Breaking changes in 15.0 and Deprecations.

  • GitLab.org
  • GitLab DocsGitLab Docs
  • Merge requests
  • !244
Project 'gitlab-com/gitlab-docs' was moved to 'gitlab-org/gitlab-docs'. Please update any links and bookmarks that may still have the old path.
Merged
Created Apr 04, 2018 by Marcia Ramos@marcia👋Contributor8 of 8 tasks completed8/8 tasks
  • Review changes

  • Download
  • Email patches
  • Plain diff

Add badges to docs

  • Overview 76
  • Commits 35
  • Pipelines 28
  • Changes 7
  • Closes https://gitlab.com/gitlab-com/gitlab-docs/issues/173
  • For https://gitlab.com/gitlab-org/gitlab-ce/issues/42631
  • TEST EE-MR for preview: https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/5233
  • Followup CE and EE MRs (adding badges): https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/18408, https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/5381

How it works

For every place we want to add the badge, we use a magic Markdown syntax: **[BADGE_TYPE]**

  • Core: **[CORE]**
  • Starter: **[STARTER]**
  • Premium: **[PREMIUM]**
  • Ultimate: **[ULTIMATE]**

Each one imply on the gitlab-dot-com equivalent, as well, so by setting core you also get free.

If you want to restrict only for on-premise, you need to specify a modifier ONLY:

**[CORE ONLY]**
**[STARTER ONLY]**
**[PREMIUM ONLY]**
**[ULTIMATE ONLY]**

On hover, it shows the availability.

How it renders on the docs site:

Review apps:

  • Test with all badges: http://badges.178.62.207.141.xip.io/ee/test.html
  • Real files:
    • http://badges.178.62.207.141.xip.io/ee/ci/examples/
    • http://badges.178.62.207.141.xip.io/ee/

Screen_Shot_2018-04-13_at_17.42.17

How it renders in GitLab markdown:

Preview: https://gitlab.com/gitlab-org/gitlab-ee/blob/a929fdcf352047f26c738503519df1c593216727/doc/test.md

markdown-fallback

How noisy the markdown file gets:

Preview: https://gitlab.com/gitlab-org/gitlab-ee/blob/a929fdcf352047f26c738503519df1c593216727/doc/test.md

### Lorem ipsum dolor sit h3 **[PREMIUM]**

Lorem ipsum dolor sit amet, consectetur adipisicing elit. **[PREMIUM]**

- **[PREMIUM]** Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis, nulla. 1
- **[ULTIMATE ONLY]** Lorem ipsum dolor sit amet, consectetur adipisicing elit. Omnis, nulla. 3

Todos

  • Fix alignment for <h5>, <h6>, <li> and <p>
  • Keep title clean from HTML or Markdown
  • GitLab.com off
  • Fix tooltips for .dotcom-false
  • Fix layout on mobile
  • FE Review
  • Revert .gitlab-ci.yml to master
  • Document how to use it https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/18408/diffs?commit_id=2654905ad5da4bb7cbcb0052fffd266d6c6cc36d
Edited Apr 17, 2018 by Marcia Ramos
Assignee
Assign to
Reviewer
Request review from
Time tracking
Source branch: badges