Skip to content

fix: resolve 37 broken links detected by lychee CI checker#14562

Merged
skjnldsv merged 1 commit intofeat/ci-lycheefrom
copilot/fix-errors-in-documentation
Apr 24, 2026
Merged

fix: resolve 37 broken links detected by lychee CI checker#14562
skjnldsv merged 1 commit intofeat/ci-lycheefrom
copilot/fix-errors-in-documentation

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 24, 2026

The lychee link checker added in #14231 found 37 broken links because the commit converting absolute https://docs.nextcloud.com/server/latest/… URLs to relative paths used .rst extensions — but lychee checks the built HTML stage, where only .html files exist.

Changes

  • .rst.html in all relative cross-manual hyperlinks across admin, developer, and user manuals
  • mysql_4byte_support.rst — reverted self-link back to absolute URL targeting v20 docs (the #mariadb-10-2-or-earlier section no longer exists in current docs)
  • coding_standards/index.rst — fixed relative path depth for codereviews link (../../../)
  • user_manual/desktop/uninstallation.rst — fixed 4 links pointing to non-existent admin_manual/desktop/configfile.html; the file lives in user_manual/desktop/, so changed to relative configfile.html#configuration-file
  • user_manual/files/access_webdav.rst — fixed self-referencing link access_webdav.rst#anchor#anchor
  • webdav.rst / office/configuration.rst — wrapped bare https:// and http:// text in inline code literals ( https:// ) to prevent docutils from auto-linking them as relative broken paths
  • .github/workflows/sphinxbuild.yml — added --exclude-path '.*/_static/.*' to lychee config to skip template files (e.g. openapi.html) that reference CDN resources not present in the stage

🖼️ Screenshots

Agent-Logs-Url: https://github.com/nextcloud/documentation/sessions/ae18fa2c-5300-4ccd-9db7-6f2c00da3a4b

Co-authored-by: nextcloud-command <88102737+nextcloud-command@users.noreply.github.com>
@skjnldsv skjnldsv changed the base branch from master to feat/ci-lychee April 24, 2026 07:44
@skjnldsv skjnldsv marked this pull request as ready for review April 24, 2026 07:45
@skjnldsv skjnldsv merged commit 0e2c77f into feat/ci-lychee Apr 24, 2026
1 check passed
@skjnldsv skjnldsv deleted the copilot/fix-errors-in-documentation branch April 24, 2026 07:45
such as Amazon S3, SMB/CIFS file servers and FTP servers…
in Nextcloud. Your Nextcloud server administrator controls which of these are
available to you. Please see `Configuring External Storage (GUI)
<../../admin_manual/configuration_files/external_storage_configuration_gui.rst>`_ in the Nextcloud Administrator's
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are you sure this is working/a good idea?
As far as I recall the RST links got resolved to HTML for HTML and also worked in the PDF by scrolling to the related section.

Not they are relative links in the PDF that lead to a relative HTML page that does not exist on the server / local PC?

But for cross manual like here we actually need to use absolute links

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants