Replace gitlab/pagure references with links to Forgejo

pbokoc commented

2026-04-02 14:08:16 +00:00

Owner

There are a bunch of links to Pagure and Gitlab in the docs, e.g. in https://docs.fedoraproject.org/en-US/fedora-docs/organizational/meetings/

Items to be discussed in meetings should be tagged with the Meeting tag. While preparing the agenda, review the issue board for items that should be tagged for the meeting.

These need to all be replaced with appropriate Forge links.

There are a bunch of links to Pagure and Gitlab in the docs, e.g. in https://docs.fedoraproject.org/en-US/fedora-docs/organizational/meetings/ >Items to be discussed in meetings should be tagged with the [Meeting](https://gitlab.com/groups/fedora/docs/-/issues?label_name=Meeting) tag. While preparing the agenda, review the [issue board](https://gitlab.com/groups/fedora/docs/-/boards) for items that should be tagged for the meeting. These need to all be replaced with appropriate Forge links.

pbokoc added the

help wanted

needs changes

labels

2026-04-02 14:10:47 +00:00

jflory7 commented

2026-04-02 15:55:19 +00:00

Owner

Here are all the existing links which need to be changed:

$ grap team-docs/ pagure.io "--exclude-dir=.git/"

team-docs/modules/ROOT/pages/contributing-docs/asciidoc-reusable-attributes.adoc:16:* URL prefixes or suffixes (e.g. `https://pagure.io/fesco/issues/`)

team-docs/modules/ROOT/pages/contributing-docs/contrib-quickdocs.adoc:76:You can find and contribute to needed changes by following the https://pagure.io/fedora-docs/quick-docs/issues[Quick Docs Issue Board], where users share blunders in the documentation or suggestions for enhancing it.

team-docs/modules/ROOT/pages/contributing-docs/contributions-quick-repo-WITHDRAWN.adoc:14:Track issues on the link: https://pagure.io/fedora-docs/quick-docs/issues

team-docs/modules/ROOT/pages/contributing-docs/contributions-quick-repo-WITHDRAWN.adoc:49:- Go to your forked project and click *View Fork* on top right of Quick Docs project landing page: https://pagure.io/fedora-docs/quick-docs

team-docs/modules/ROOT/pages/contributing-docs/tools-localenv-preview.adoc:62:  - url: https://pagure.io/fedora-docs/another-repository.git

team-docs/modules/ROOT/pages/contributing-docs/tools-localenv-preview.adoc:67:https://pagure.io/fedora-docs/docs-fp-o/blob/prod/f/site.yml[docs-fp-o site.yml].

Here are all the existing links which need to be changed: ```sh $ grap team-docs/ pagure.io "--exclude-dir=.git/" team-docs/modules/ROOT/pages/contributing-docs/asciidoc-reusable-attributes.adoc:16:* URL prefixes or suffixes (e.g. `https://pagure.io/fesco/issues/`) team-docs/modules/ROOT/pages/contributing-docs/contrib-quickdocs.adoc:76:You can find and contribute to needed changes by following the https://pagure.io/fedora-docs/quick-docs/issues[Quick Docs Issue Board], where users share blunders in the documentation or suggestions for enhancing it. team-docs/modules/ROOT/pages/contributing-docs/contributions-quick-repo-WITHDRAWN.adoc:14:Track issues on the link: https://pagure.io/fedora-docs/quick-docs/issues team-docs/modules/ROOT/pages/contributing-docs/contributions-quick-repo-WITHDRAWN.adoc:49:- Go to your forked project and click *View Fork* on top right of Quick Docs project landing page: https://pagure.io/fedora-docs/quick-docs team-docs/modules/ROOT/pages/contributing-docs/tools-localenv-preview.adoc:62: - url: https://pagure.io/fedora-docs/another-repository.git team-docs/modules/ROOT/pages/contributing-docs/tools-localenv-preview.adoc:67:https://pagure.io/fedora-docs/docs-fp-o/blob/prod/f/site.yml[docs-fp-o site.yml]. ```

pbokoc commented

2026-04-02 16:40:59 +00:00

Author

Owner

The above is just for Pagure, here are all references to Gitlab. Both will have to be updated. I didn't realize before but we have a bunch of Gitlab screenshots in the docs as well, those will need to be all replaced too.

(Also what the hell is a grap? 😀)

$ grep -rn "gitlab" team-docs/ --exclude-dir={.git,build,cache,public}

team-docs/README.md:53:**NOTE**: Please note that if you reference pages from other repositories, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://gitlab.com/fedora/docs/-/boards) for instructions.

team-docs/docsbuilder.sh:20:script_source="https://gitlab.com/fedora/docs/templates/fedora-docs-template/-/raw/main/${script_name}"

team-docs/modules/ROOT/pages/contributing-docs/asciidoc-markup.adoc:151:The list of supported languages can be found in the https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/blob/main/src/js/vendor/highlight.bundle.js[highlight.bundle.js in the Fedora Docs UI].

team-docs/modules/ROOT/pages/contributing-docs/asciidoc-reusable-attributes.adoc:73::team_issue_tracker: https://gitlab.com/fedora/dei/home/

team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:20:You can host this repository anywhere but we recommend using https://gitlab.com/fedora[GitLab] where you can use Fedora groups to control write access to the repository.

team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:21:Depending on the topic, it might be preferable to host it under the https://gitlab.com/fedora/docs[Fedora Docs namespace].  

team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:25:If you are not using GitLab, clone the https://gitlab.com/fedora/docs/templates/fedora-docs-template[template repository] manually and copy the content to your new repository.

team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:66:Documentation modules published on docs.fp-o are all listed in the https://gitlab.com/fedora/docs/docs-website/docs-fp-o/-/blob/prod/site.yml[main Antora playbook].

team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:74:  - url: https://gitlab.com/path/to/new/repository.git

team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:82:You can either create a Merge Request with these changes, or if you do not feel comfortable editing this file, create a ticket on the  https://gitlab.com/fedora/docs/docs-website/docs-fp-o/-/issues[Fedora Docs Website repository], and the Documentation Team will handle that part for you.

team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:34:- Use the https://gitlab.com/groups/fedora/-/saml/sso[SAML link] to link your account to FAS

team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:78:image::gitlab-ui/update-fork-no.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:83:image::gitlab-ui/update-fork-yes.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:108:image::gitlab-ui/editor.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:119:image::gitlab-ui/commit.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:128:image::gitlab-ui/create-mr.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:30:image::gitlab-ui/explorer-intro.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:37:image::gitlab-ui/source-control.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:42:image::gitlab-ui/commit.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:48:- https://gitlab.com/fedora/docs/community-tools/documentation-contributors-guide/-/tree/main/.vale/styles/RedHat[Contributor Guides]

team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:50:- https://gitlab.com/fedora/docs/docs-website/pages/-/tree/main/.vale/styles/RedHat[Docs Home Page]

team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:66:image::gitlab-ui/view-app.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:71:image::gitlab-ui/preview.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:82:image::gitlab-ui/pipeline.png[]

team-docs/modules/ROOT/pages/contributing-docs/tools-vale-linter.adoc:33:The Red Hat style guide and the required Vale configuration files are already installed and available in the repository you forked from the main https://gitlab.com/fedora/docs[Fedora Docs] page in GitLab.

team-docs/modules/ROOT/pages/contributing-docs/tools-vale-linter.adoc:157:This guide shows how to use Vale from the command line, but https://docs.gitlab.com/ee/development/documentation/testing.html#configure-editors[plugins or packages] are available for several common text editors.

team-docs/modules/ROOT/pages/contributing-infra/design-ux-contribution.adoc:15:https://gitlab.com/fedora/docs/docs-website/ui-bundle[*fedora-docs-ui*]::

team-docs/modules/ROOT/pages/index.adoc:57:We are currently in the process of moving all our documentaion from the pagure git repository to gitlab, to make use of several advanced features.

team-docs/modules/ROOT/pages/locations.adoc:13:* Repositories on gitlab

team-docs/modules/ROOT/pages/organizational/meetings.adoc:11:Items to be discussed in meetings should be tagged with the link:++https://gitlab.com/groups/fedora/docs/-/issues?label_name=Meeting++[Meeting] tag.

team-docs/modules/ROOT/pages/organizational/meetings.adoc:12:While preparing the agenda, review the https://gitlab.com/groups/fedora/docs/-/boards[issue board] for items that should be tagged for the meeting.

team-docs/modules/ROOT/pages/organizational/meetings.adoc:43:(e.g. Release Notes that need to be written, upcoming deadlines, a link to the https://gitlab.com/groups/fedora/docs/-/boards[issue board], etc.)

team-docs/modules/ROOT/pages/organizational/workflow.adoc:10:https://gitlab.com/groups/fedora/docs/-/boards[GitLab dashboard] 

team-docs/modules/ROOT/pages/organizational/workflow.adoc:12:https://gitlab.com/groups/fedora/docs/-/merge_requests[GitLab Open Merge Requests]

team-docs/modules/ROOT/nav.adoc:15:*** xref:contributing-docs/tools-gitlab-howto.adoc[HowTo for casual contributions (for GitLab-based pages)]

team-docs/site.yml:10:    url: https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable

The above is just for Pagure, here are all references to Gitlab. Both will have to be updated. I didn't realize before but we have a bunch of Gitlab screenshots in the docs as well, those will need to be all replaced too. (Also what the hell is a `grap`? 😀) ~~~ $ grep -rn "gitlab" team-docs/ --exclude-dir={.git,build,cache,public} team-docs/README.md:53:**NOTE**: Please note that if you reference pages from other repositories, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://gitlab.com/fedora/docs/-/boards) for instructions. team-docs/docsbuilder.sh:20:script_source="https://gitlab.com/fedora/docs/templates/fedora-docs-template/-/raw/main/${script_name}" team-docs/modules/ROOT/pages/contributing-docs/asciidoc-markup.adoc:151:The list of supported languages can be found in the https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/blob/main/src/js/vendor/highlight.bundle.js[highlight.bundle.js in the Fedora Docs UI]. team-docs/modules/ROOT/pages/contributing-docs/asciidoc-reusable-attributes.adoc:73::team_issue_tracker: https://gitlab.com/fedora/dei/home/ team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:20:You can host this repository anywhere but we recommend using https://gitlab.com/fedora[GitLab] where you can use Fedora groups to control write access to the repository. team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:21:Depending on the topic, it might be preferable to host it under the https://gitlab.com/fedora/docs[Fedora Docs namespace]. team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:25:If you are not using GitLab, clone the https://gitlab.com/fedora/docs/templates/fedora-docs-template[template repository] manually and copy the content to your new repository. team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:66:Documentation modules published on docs.fp-o are all listed in the https://gitlab.com/fedora/docs/docs-website/docs-fp-o/-/blob/prod/site.yml[main Antora playbook]. team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:74: - url: https://gitlab.com/path/to/new/repository.git team-docs/modules/ROOT/pages/contributing-docs/contrib-new-documentation.adoc:82:You can either create a Merge Request with these changes, or if you do not feel comfortable editing this file, create a ticket on the https://gitlab.com/fedora/docs/docs-website/docs-fp-o/-/issues[Fedora Docs Website repository], and the Documentation Team will handle that part for you. team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:34:- Use the https://gitlab.com/groups/fedora/-/saml/sso[SAML link] to link your account to FAS team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:78:image::gitlab-ui/update-fork-no.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:83:image::gitlab-ui/update-fork-yes.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:108:image::gitlab-ui/editor.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:119:image::gitlab-ui/commit.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-gitlab-howto.adoc:128:image::gitlab-ui/create-mr.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:30:image::gitlab-ui/explorer-intro.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:37:image::gitlab-ui/source-control.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:42:image::gitlab-ui/commit.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:48:- https://gitlab.com/fedora/docs/community-tools/documentation-contributors-guide/-/tree/main/.vale/styles/RedHat[Contributor Guides] team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:50:- https://gitlab.com/fedora/docs/docs-website/pages/-/tree/main/.vale/styles/RedHat[Docs Home Page] team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:66:image::gitlab-ui/view-app.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:71:image::gitlab-ui/preview.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-web-ide-ui.adoc:82:image::gitlab-ui/pipeline.png[] team-docs/modules/ROOT/pages/contributing-docs/tools-vale-linter.adoc:33:The Red Hat style guide and the required Vale configuration files are already installed and available in the repository you forked from the main https://gitlab.com/fedora/docs[Fedora Docs] page in GitLab. team-docs/modules/ROOT/pages/contributing-docs/tools-vale-linter.adoc:157:This guide shows how to use Vale from the command line, but https://docs.gitlab.com/ee/development/documentation/testing.html#configure-editors[plugins or packages] are available for several common text editors. team-docs/modules/ROOT/pages/contributing-infra/design-ux-contribution.adoc:15:https://gitlab.com/fedora/docs/docs-website/ui-bundle[*fedora-docs-ui*]:: team-docs/modules/ROOT/pages/index.adoc:57:We are currently in the process of moving all our documentaion from the pagure git repository to gitlab, to make use of several advanced features. team-docs/modules/ROOT/pages/locations.adoc:13:* Repositories on gitlab team-docs/modules/ROOT/pages/organizational/meetings.adoc:11:Items to be discussed in meetings should be tagged with the link:++https://gitlab.com/groups/fedora/docs/-/issues?label_name=Meeting++[Meeting] tag. team-docs/modules/ROOT/pages/organizational/meetings.adoc:12:While preparing the agenda, review the https://gitlab.com/groups/fedora/docs/-/boards[issue board] for items that should be tagged for the meeting. team-docs/modules/ROOT/pages/organizational/meetings.adoc:43:(e.g. Release Notes that need to be written, upcoming deadlines, a link to the https://gitlab.com/groups/fedora/docs/-/boards[issue board], etc.) team-docs/modules/ROOT/pages/organizational/workflow.adoc:10:https://gitlab.com/groups/fedora/docs/-/boards[GitLab dashboard] team-docs/modules/ROOT/pages/organizational/workflow.adoc:12:https://gitlab.com/groups/fedora/docs/-/merge_requests[GitLab Open Merge Requests] team-docs/modules/ROOT/nav.adoc:15:*** xref:contributing-docs/tools-gitlab-howto.adoc[HowTo for casual contributions (for GitLab-based pages)] team-docs/site.yml:10: url: https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable ~~~