We want to have a modern documentation site that reflects GitLab as an enterprise software company. In the 18.1 milestone (and potential future milestones), we are going to do some work to improve the look and feel of the docs site. ## Areas of focus The primary areas of focus are: - **Homepage** A blend between the marketing site and the product. - **Overall look and feel** Styles, spacing/margins, font sizes, format of tabs, alerts, videos, code blocks, etc. - **Accessibility** - **Dark mode** (See [exploration MR](https://gitlab.com/gitlab-org/technical-writing/docs-gitlab-com/-/merge_requests/531)) - **Navigation** - **Tables** - **Videos and walkthroughs** (Including [Developer Relations walkthroughs](https://gitlab.com/gitlab-org/gitlab/-/issues/505063) and [youtube videos](https://docs.gitlab.com/development/documentation/styleguide/#link-to-video).) - **Footer** If time/stretch goals: - [**Deprecations page**](https://docs.gitlab.com/update/deprecations/) - [**Feature flags**](https://docs.gitlab.com/development/documentation/feature_flags/) ## Design ideas [❈ Figma file](https://www.figma.com/design/8SyoJ7QPtz7CWhOtq5hAcz/%F0%9F%A4%94-Miocene-s-ideas-exploration?node-id=2858-15050&t=DaelPXjinR6gMSFo-0) | lg | md | md | sm | sm | | ------ | ------ | ------ | ------ | ------ | |  |  |  |  |  | |  |  |  |  |  | ## Other resources/links - [Proposal for using numbers in our tasks](https://gitlab.com/gitlab-org/technical-writing/docs-gitlab-com/-/issues/203). - [Discussion of fixed widths](https://gitlab.com/gitlab-org/technical-writing/docs-gitlab-com/-/issues/257). - [Adding a feedback mechanism to the footer](https://gitlab.com/gitlab-org/technical-writing/docs-gitlab-com/-/issues/202). - There is a contributors.gitlab.com site and we've discussed [publishing the "Contribute" content there](https://gitlab.com/gitlab-org/developer-relations/contributor-success/contributors-gitlab-com/-/issues/139). - Our [four main topic types](https://docs.gitlab.com/development/documentation/topic_types/) are concept, task, reference, and troubleshooting. We also have Getting started and Tutorial styles. --- UX Paper Cuts planning issue: https://gitlab.com/gitlab-org/gitlab/-/issues/513102 https://gitlab.com/gitlab-org/gitlab/-/issues/513105