See the Marketing Site Information Architecture Refresh epic for single source of truth of pages being migrated to this repository.
Other keywords that may help folks find this section when searching the handbook:
In order to meet the goals of the information architecture refresh and serve the business, the Digital Experience team will need to move existing content, and in some cases, remove existing content.
We will do our best to find a solution that meets the business goals of the migration, and keeps your existing processes intact. We apologize in advance for any inconveniences incurred by this work. We will be doing our best to communicate with stakeholders in advance, but due to the scope of the migration, we may miss appropriate channels from time to time.
If we have moved or removed your content and it's causing problems for you, your team, customers, or other stakeholders, here are steps you can take to escalate these issues to us:
www-gitlab-com
repository.#digital-experience-team
Slack channel.All content is stored in the /content directory and can be accessed via the Nuxt content module
/solutions/
, /partners/
, /topics/
) the components will already be built for you. If it is a completely new page, please request support from the Digital Experience Team via this issue template..yml
file. Please follow existing indentation and convention.Reviewer
. Only the Digital Experience Team will be able to merge.Probably not. As we reduce the size and scope of the marketing site, we will be raising the bar for the quality of our page design. Content management systems present significant challenges in quality control.
In order to keep the Buyer Experience looking as good as possible, we have decided not to allow for markdown or rich text editing experiences. Instead, all data will continue to be rendered with the aforementioned Nuxt Content Module. Most data should live in YAML files as structured blocks of strings. There may be call for some numerical data from time to time. We will not allow or support markdown or other rich text strings, with the notable exception that some text elements may need inline links, which we can store as single p
tags with anchors in them, and render with Vue.js v-html
attributes.
By making this decision, we will be simplifying and streamlining our architecture, and making changes to the website more predictable and manageable. The cost is that some content editors may need to wait longer for engineers to implement their changes. Fortunately, in 2022, we only saw about 2-3 requests per month that required this kind of work across the Buyer Experience repository and www-gitlab-com repository.
If, in any particular quarter, we spend more than two weeks doing content updates implemented by engineering, we should revisit the need for a content management system.
The README.md at the repository root and our /docs directory.
See /docs/deployments.md.