GitLab 9.3 release post

Review Apps link: https://release-9-3.about.gitlab.com/2017/06/22/gitlab-9-3-released/

Release Post 🎉

• Blog handbook: https://about.gitlab.com/handbook/marketing/blog/
• Release post handbook: https://about.gitlab.com/handbook/marketing/blog/release-posts/

General Contributions

General contributions from the team.

Due date: 06/14 (6th working day before the 22nd)

• Label MR: blog post release
• Add milestone
• Intro
• MVP
• Add cover image image_title (compressed)
• Upgrade barometer
• Top features
• Primary features
• Secondary features (improvements)
• Performance improvements
• Omnibus improvements
• Deprecations
• Documentation links
• Authorship (author's data)

Review

Content review (PMs)

Due date: 06/19 (2nd working day before the 22nd)

• Label MR: blog post release review-in-progress
• General review (PM)
  • Check Features' names
  • Check Features' availability (CE, EES, EEP)
  • Check Documentation links
  • Update data/promo.yml
  • Check all images' size - compress whenever > 300KB
  • Meaningful links (SEO)
  • Check links to product/feature webpages
• Copyedit (Sean P, Rebecca, or Marcia)
  • Title
  • Description
  • Grammar, spelling, clearness (body)
• Final review (Job)

Structural Check

Due date: 06/19 (2nd working day before the 22nd)

• Label MR: blog post release review-structure
• Check frontmatter (entries, syntax)
• Check image_title and twitter_image
• Check image shadow {:.shadow}
• Check images' ALT text
• Videos/iframes wrapped in <figure> tags (responsiveness)
• Add/check <!-- more --> separator
• Add/check cover img reference (at the end of the post)
• Columns (content balance between the columns)
• Badges consistency (applied to all headings)
• Remove any remaining instructions
• Remove HTML comments
• Run deadlink checker
• Update release template with any changes (if necessary)

data/release_posts/2017_06_22_gitlab_9_3_released.yml

@@ -29,7 +29,6 @@ features:
     - name: GitLab Code Quality
       available_in: [ees, eep]
       documentation_link: 'https://docs.gitlab.com/ee/user/project/merge_requests/code_quality_diff.html'
-      documentation_text: "Documentation for GitLab Code Quality"
       image_url: '/images/9_3/code_climate.png'
       description: |
         When submitting new code with a [GitLab CI/CD](/features/gitlab-ci-cd/) pipeline,
@@ -47,7 +46,6 @@ features:
     - name: Multi-Project Pipeline Graphs
       available_in: [eep]
       documentation_link: 'https://docs.gitlab.com/ee/ci/pipelines.html#multi-project-pipelines-graph'
-      documentation_text: "Documentation for Multi-Project Pipeline Graphs"
       image_url: '/images/9_3/multi-project_pipelines.png'
       description: |
         Larger projects, especially those adopting [microservices
@@ -59,7 +57,6 @@ features:
     - name: Conversational Development Index
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/admin_area/monitoring/convdev.html'
-      documentation_text: "Documentation for Conversational Development Index"
       image_url: '/images/9_3/conversational_development_index.png'
       description: |
         GitLab is a fully featured software development platform to help
@@ -80,7 +77,7 @@ features:
     - name: Protected Variables for Enhanced Pipelines Security
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/ci/variables/#protected-secret-variables'
-      documentation_text: "Documentation for Protected Secret Variables"
+      documentation_text: "Read through the documentation on Protected Secret Variables"
       image_url: '/images/9_3/protected_variables.png'
       description: |
         Secret variables are very useful if you want to avoid external people to
@@ -97,7 +94,7 @@ features:
     - name: Centralized Audit Log & Extended User Audit Actions #review pending feedback https://gitlab.com/gitlab-com/www-gitlab-com/merge_requests/5804/diffs#note_32568465
       available_in: [eep]
       documentation_link: 'https://docs.gitlab.com/ee/administration/audit_events.html#audit-log-admin-only'
-      documentation_text: "Documentation for Audit Log"
+      documentation_text: "Read through the documentation on Audit Logs"
       image_url: '/images/9_3/audit_log.png'
       description: |
         Many companies have the need for audit and compliance across the
@@ -128,7 +125,7 @@ features:
     - name: Confidential Issues Re-Design
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/project/issues/confidential_issues.html'
-      documentation_text: "Documentation for Confidential Issues"
+      documentation_text: "Read through the documentation on Confidential Issues"
       image_url: '/images/9_3/confidential_issues_re_design.png'
       description: |
         We tweaked the design of confidential issues in this release, making
@@ -141,7 +138,7 @@ features:
     - name: JIRA Settings Improvements
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/project/integrations/jira.html'
-      documentation_text: "Documentation for JIRA integration"
+      documentation_text: "Read through the documentation on JIRA integration"
       image_url: '/images/9_3/jira_settings_improvements.png'
       description: |
         For JIRA users, we improved the JIRA integration settings in this release,
@@ -154,7 +151,7 @@ features:
     - name: Snippet Descriptions
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/snippets.html'
-      documentation_text: "Documentation for GitLab Snippets"
+      documentation_text: "Read through the documentation on GitLab Snippets"
       image_url: '/images/9_3/snippet_descriptions.png'
       description: |
         Snippets now have descriptions. This follows personal snippet comments, which
@@ -166,7 +163,7 @@ features:
     - name: Group Label Permissions #review pending feedback https://gitlab.com/gitlab-com/www-gitlab-com/merge_requests/5804/diffs#note_32569203
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/permissions.html'
-      documentation_text: "Documentation for GitLab's permission model"
+      documentation_text: "Read through the documentation on GitLab's permission model"
       description: |
         The Reporter, Developer, Master, and Owner roles can now **create and edit**
         group labels. Previously, only Master and Owner roles could do this. This
@@ -193,7 +190,7 @@ features:
     - name: "Edit Issue Description Inline, Without Losing Context"
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/project/issues/index.html'
-      documentation_text: "Documentation for GitLab Issues"
+      documentation_text: "Read through the documentation on GitLab Issues"
       image_url: '/images/9_3/issue_description_inline_edit.png'
       description: |
         The issue description serves as the single source of truth when teams
@@ -208,7 +205,7 @@ features:
     - name: "Bulk-Editing Issues Re-Design"
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/project/issues/index.html'
-      documentation_text: "Documentation for GitLab Issues"
+      documentation_text: "Read through the documentation on GitLab Issues"
       image_url: '/images/9_3/bulk_issue_edit_re_design.png'
       description: |
         We've made bulk editing issues even simpler and more intuitive in
@@ -218,8 +215,8 @@ features:
     - name: Issue Board Usability Improvements
       available_in: [ce, ees, eep]
-      documentation_link: 'https://docs.gitlab.com/ce/user/project/issue_board.html'
-      documentation_text: "Documentation for GitLab Issue Boards"
+      documentation_link: '/features/issueboard/'
+      documentation_text: "Learn more about GitLab Issue Boards"
       image_url: '/images/9_3/issue_board_usability_improvements.png'
       description: |
         We recognize that teams use Issue Boards in a variety of ways. To make
@@ -232,7 +229,7 @@ features:
     - name: Search/Filter Bar Improvements
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/search/'
-      documentation_text: "Documentation for searching through GitLab"
+      documentation_text: "Read through the documentation on searching through GitLab"
       image_url: '/images/9_3/search_filter_bar_improvements.png'
       description: |
         We continue to make incremental improvements to the search/filter bar. You
@@ -244,7 +241,7 @@ features:
     - name: Internationalization of Project Home & Repository Files Pages
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/development/i18n_guide.html'
-      documentation_text: "Documentation for contributing to translate GitLab"
+      documentation_text: "Learn how to contribute to translate GitLab"
       image_url: '/images/9_3/project-page-spanish.png'
       description: |
         In [GitLab 9.2](/2017/05/22/gitlab-9-2-released/#internationalized-cycle-analytics)
@@ -264,7 +261,7 @@ features:
     - name: Improvements to GitLab Subgroups
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/group/subgroups/'
-      documentation_text: "Documentation for GitLab Subgroups"
+      documentation_text: "Read through the documentation on GitLab Subgroups"
       image_url: '/images/9_3/subgroups.png'
       description: |
         In GitLab 9.0 we [introduced Subgroups](/2017/03/22/gitlab-9-0-released/#subgroups-ce-ee),
@@ -279,7 +276,7 @@ features:
     - name: Access private Container Registry images
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/profile/personal_access_tokens.html'
-      documentation_text: "Documentation for Personal Access Tokens"
+      documentation_text: "Read through the documentation on Personal Access Tokens"
       image_url: '/images/9_3/pat_registry.png'
       description: |
         When you deploy your docker-based project, you need to pull your image
@@ -296,7 +293,7 @@ features:
     - name: Object Storage for CI Artifacts
       available_in: [eep]
       documentation_link: 'https://docs.gitlab.com/ee/administration/job_artifacts.html#using-object-storage'
-      documentation_text: "Documentation for using an object storage for CI Artifacts"
+      documentation_text: "Read through the documentation on Object Storage for CI Artifacts"
       image_url:
       description: |
         As companies continue to embrace CI/CD across the organization, their
@@ -351,7 +348,7 @@ features:
     - name: API Support for Pipeline Schedules
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/api/pipeline_schedules.html'
-      documentation_text: "Documentation for Pipeline Schedules API"
+      documentation_text: "Read through the documentation on Pipeline Schedules' API"
       image_url:
       description: |
         In GitLab 9.2 we
@@ -364,7 +361,7 @@ features:
     - name: GitLab Runner 9.3
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/runner/'
-      documentation_text: "Documentation for GitLab Runner in our docs."
+      documentation_text: "Read through the documentation on GitLab Runner."
       image_url:
       description: |
         We're also releasing GitLab Runner 9.3 today!
@@ -383,7 +380,7 @@ features:
     - name: Performance Impact of Merge Requests now Quantified
       available_in: [ce, ees, eep]
       documentation_link: 'https://docs.gitlab.com/ce/user/project/integrations/prometheus.html#determining-the-performance-impact-of-a-merge'
-      documentation_text: "Documentation for monitoring your apps with Prometheus"
+      documentation_text: "Read through the documentation on monitoring your apps with Prometheus"
       image_url: '/images/9_3/metrics-quantified.png'
       description: |
         With
@@ -417,7 +414,6 @@ features:
     - name: Omnibus Improvements
       available_in: [ce, ees, eep]
-      documentation_link:
       image_url:
       description: |
         <h4 id="gitlab-mattermost-3_9">GitLab Mattermost 3.10</h4>