Skip to content

Features in one yaml

Now there is lots of overlap between the various yml files. Can't we have one and just indicate where it should appear?

We list our features multiple times:

  1. Features page: On https://about.gitlab.com/features/
  2. Boxes: On https://about.gitlab.com/products/ in the boxes
  3. Matrix: On https://about.gitlab.com/products/ in the comparison table
  4. Comparison page: https://about.gitlab.com/comparison/
  5. EE page: On https://about.gitlab.com/gitlab-ee/

This leads to duplicate work for our team members, confusion with our potential customers, and a lack of updates. For example of the four listings only the comparison table has service desk https://about.gitlab.com/products/

Additional problems:

Proposal:

  1. DONE Make a single comparison.yml file with one format #1334 (comment 28834379) (add CE/EES/EEP to comparison yml, named entries for competitors, have doc links for all comparison items, have feature page url for comparison.yml if that is available) and create the comparison page from it
  2. DONE Create simplified product page from comparison.yml #1370 (closed)
  3. DONE Add a matrix to the products page
  4. DONE On https://about.gitlab.com/comparison/ remove comparisons of GitLab to GitLab, for example gitlab-ce-vs-gitlab-ee.html
  5. DONE On https://about.gitlab.com/features/ create three sections CE, EES, EEP. at the top of the page explain that there are three versions, deeplink to EES and EEP further down the page. List all features that have a documentation link or feature page link. When they have a feature page link to that, otherwise link to the documentation link (same as current page, use the same text to link). Keep the page simple boxes for now. Add a screenshot_url to the yaml so that the feature page can show screenshots for the features that have it. 156 features in the yaml, about 120 relevant for this page. Have each feature be: title, description, small screenshot, link. Title, description, link are the same as now on the page. If you click the small screenshot it gets bigger. Have as many on a row as fit on the screen (probably 1 for mobile). Start with the features that have a screenshot so rows without them can be less high. Deprecate the icons since they are hard to add for new features.
  6. DONE Rename comparison.yml to features.yml (we need to add new features there, it is used for non comparison pages, for example also the ROI calculator)
  7. DONE Fix the /gitlab-com page #1446 (closed)
  8. DONE On /gitlab-com/ and /products remove the line above the first feature of the left most plan, on /products remove the line above the other plans too
  9. DONE On /gitlab-com have a contact-us button below the plans
  10. DONE On /gitlab-com remove the whitespace between 'No installation required / Easy import' and 'Below is the'
  11. DONE Make sure that on https://about.gitlab.com/comparison/ the title and menu item are generated from the same source. Short term fix was done in #1475 (closed) Done in !6536 (merged)
  12. DONE The comparison page should have consistent naming (GitLab.com Silver and GitLab EEP)
  13. DONE Note in the comparison page where to find comparisons of GitLab versions !6644 (merged)
  14. DONE Auto generate the list of features not available on GitLab.com listed in the FAQ on /gitlab-com/ !6733 (merged)
  15. DONE Review feature manual https://gitlab.com/gitlab-com/www-gitlab-com/blob/master/doc/features.md and make sure it is linked from relevant places
  16. DONE Order by subject #1478 (closed)

Note: Things like premium support are also a feature and can be added to features.yml

Edited by Sid Sijbrandij