Welcome to mirror list, hosted at ThFree Co, Russian Federation.

gitlab.com/gitlab-org/gitlab-docs.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDavid O'Regan <doregan@gitlab.com>2022-06-01 12:48:54 +0300
committerDavid O'Regan <doregan@gitlab.com>2022-06-01 12:48:54 +0300
commitf27a20d552efe15c04c6eb0b964a9e1296f0272c (patch)
tree3b7a7f5195371c75c24d74b5ce9e69b1d22e7d15 /doc
parent417771dc8705265f1d30db110d94b9870e76c264 (diff)
parentcb2b3c351449420e3d42c74a1eb14a3b44cb7c35 (diff)
Merge branch '361-js-cdns' into 'main'
Bundle Bootstrap JS and jQuery with Rollup See merge request gitlab-org/gitlab-docs!2749
Diffstat (limited to 'doc')
-rw-r--r--doc/development.md10
1 files changed, 8 insertions, 2 deletions
diff --git a/doc/development.md b/doc/development.md
index 144544c7..a41edb63 100644
--- a/doc/development.md
+++ b/doc/development.md
@@ -68,6 +68,12 @@ match to make it easier to find:
You should replace `<bundle-name>` with whatever you'd like to call your
bundle.
+### Add a global library
+
+Libraries that are not specific to individual components (e.g, jQuery) are bundled via `global_imports.js`. The resulting build is included on all pages.
+
+This is a pattern to avoid going forward -- ideally third-party libraries are only loaded from components that require them -- but this allows us to utilize yarn for package management and avoid external CDNs while the site is still only partially component-driven.
+
## Bump versions of CSS and JavaScript
Whenever the custom CSS and JavaScript files under `content/assets/` change,
@@ -92,7 +98,7 @@ The links pointing to the files should be similar to:
Nanoc then builds and renders those links correctly according with what's
defined in [`Rules`](https://gitlab.com/gitlab-org/gitlab-docs/-/blob/main/Rules).
-## Adding query strings to CTAs headed to about.gitlab.com/pricing
+## Adding query strings to CTAs headed to about.gitlab.com/pricing
We've created [a Sisense dashboard that can only be seen by full-time team members](https://app.periscopedata.com/app/gitlab/950797/GitLab.com-SaaS-trials---no-SAFE-data)
to track the number of SaaS free trials that start from a documentation page.
@@ -102,7 +108,7 @@ If you would like to track that information, add the following parameters to the
- `glm_source` is `docs.gitlab.com`
- `glm_content` set to anything that ends with `-docs`
-### Example:
+### Example
`https://about.gitlab.com/pricing?=glm_source=docs.gitlab.com&glm_content=name-of-item-docs`