Skip to content

Comments

fix: add index md files to indicate subfolders for render trailing slashes…#606

Closed
AlexAndBear wants to merge 5 commits intomainfrom
seo-fix
Closed

fix: add index md files to indicate subfolders for render trailing slashes…#606
AlexAndBear wants to merge 5 commits intomainfrom
seo-fix

Conversation

@AlexAndBear
Copy link
Member

… if its a category

Copilot AI review requested due to automatic review settings January 22, 2026 11:01
@github-actions
Copy link

Label error. Requires at least 1 of: Docs:User, Docs:Admin, Docs:Developer, Docs:Breaking-Change, Docs:Build&Tools, Docs:Guides. Found:

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR refactors documentation structure by migrating from generated category index pages to explicit index.md files for documentation categories. This change enables proper rendering of trailing slashes in URLs for category pages.

Changes:

  • Replaced generated-index link configurations in _category_.json files with explicit index.md files
  • Moved category descriptions and titles from JSON configuration to markdown frontmatter
  • Simplified _category_.json files by removing link objects while preserving labels and positions

Reviewed changes

Copilot reviewed 96 out of 96 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
versioned_docs/version-4.0/user/spaces/index.md Added explicit index page for Spaces category
versioned_docs/version-4.0/user/spaces/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/user/sharing/index.md Added explicit index page for sharing category
versioned_docs/version-4.0/user/sharing/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/user/roles/index.md Added explicit index page for roles category
versioned_docs/version-4.0/user/roles/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/user/ios-app/shares/index.md Added explicit index page for iOS shares category
versioned_docs/version-4.0/user/ios-app/shares/_category_.json Removed generated-index link configuration while preserving key
versioned_docs/version-4.0/user/ios-app/general/overview/index.md Added explicit index page for iOS overview category
versioned_docs/version-4.0/user/ios-app/general/overview/_category_.json Removed generated-index link configuration while preserving key
versioned_docs/version-4.0/user/ios-app/general/index.md Added explicit index page for iOS general category
versioned_docs/version-4.0/user/ios-app/general/_category_.json Removed generated-index link configuration while preserving key
versioned_docs/version-4.0/user/ios-app/files-and-folders/index.md Added explicit index page for iOS files category
versioned_docs/version-4.0/user/ios-app/files-and-folders/_category_.json Removed generated-index link configuration while preserving key
versioned_docs/version-4.0/user/files-and-folders/index.md Added explicit index page for files category
versioned_docs/version-4.0/user/files-and-folders/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/user/desktop-client/windows/index.md Added explicit index page for Windows desktop client
versioned_docs/version-4.0/user/desktop-client/windows/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/user/desktop-client/macos/index.md Added explicit index page for MacOS desktop client
versioned_docs/version-4.0/user/desktop-client/macos/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/user/desktop-client/linux/index.md Added explicit index page for Linux desktop client
versioned_docs/version-4.0/user/desktop-client/linux/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/user/desktop-client/common-functionality/index.md Added explicit index page for common functionality
versioned_docs/version-4.0/user/desktop-client/common-functionality/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/user/android-app/shares/index.md Added explicit index page for Android shares category
versioned_docs/version-4.0/user/android-app/shares/_category_.json Removed generated-index link configuration while preserving key
versioned_docs/version-4.0/user/android-app/general/overview/index.md Added explicit index page for Android overview category
versioned_docs/version-4.0/user/android-app/general/overview/_category_.json Removed generated-index link configuration while preserving key
versioned_docs/version-4.0/user/android-app/general/index.md Added explicit index page for Android general category
versioned_docs/version-4.0/user/android-app/general/_category_.json Removed generated-index link configuration while preserving key
versioned_docs/version-4.0/user/android-app/files-and-folders/index.md Added explicit index page for Android files category
versioned_docs/version-4.0/user/android-app/files-and-folders/_category_.json Removed generated-index link configuration while preserving key
versioned_docs/version-4.0/user/admin/index.md Added explicit index page for admin category
versioned_docs/version-4.0/user/admin/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/dev/web/testing/index.md Added explicit index page for testing category
versioned_docs/version-4.0/dev/web/testing/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/dev/web/development/index.md Added explicit index page for development category
versioned_docs/version-4.0/dev/web/development/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/admin/resources/index.md Added explicit index page for resources category
versioned_docs/version-4.0/admin/resources/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/admin/maintenance/upgrade/index.md Added explicit index page for upgrade category
versioned_docs/version-4.0/admin/maintenance/upgrade/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/admin/maintenance/index.md Added explicit index page for maintenance category
versioned_docs/version-4.0/admin/maintenance/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/admin/getting-started/index.md Added explicit index page for getting started category
versioned_docs/version-4.0/admin/getting-started/_category_.json Removed generated-index link configuration
versioned_docs/version-4.0/admin/configuration/index.md Added explicit index page for configuration category
versioned_docs/version-4.0/admin/configuration/_category_.json Removed generated-index link configuration
docs/user/spaces/index.md Added explicit index page for Spaces category (current version)
docs/user/spaces/_category_.json Removed generated-index link configuration (current version)
All remaining docs/* files Mirror changes from versioned_docs for current documentation version
Comments suppressed due to low confidence (2)

docs/user/ios-app/shares/index.md:1

  • Missing preposition 'in' or 'with' before 'the OpenCloud iOS App'. Should be 'Tutorials about creating shares in the OpenCloud iOS App.' or similar.
    docs/user/android-app/shares/index.md:1
  • Missing preposition 'in' or 'with' before 'the OpenCloud Android App'. Should be 'Tutorials about creating shares in the OpenCloud Android App.' or similar.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

title: Shares
---

Tutorials about creating shares the OpenCloud iOS App.
Copy link

Copilot AI Jan 22, 2026

Choose a reason for hiding this comment

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

Missing preposition 'in' or 'with' before 'the OpenCloud iOS App'. Should be 'Tutorials about creating shares in the OpenCloud iOS App.' or similar.

Suggested change
Tutorials about creating shares the OpenCloud iOS App.
Tutorials about creating shares in the OpenCloud iOS App.

Copilot uses AI. Check for mistakes.
title: Shares
---

Tutorials about creating shares the OpenCloud Android App.
Copy link

Copilot AI Jan 22, 2026

Choose a reason for hiding this comment

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

Missing preposition 'in' or 'with' before 'the OpenCloud Android App'. Should be 'Tutorials about creating shares in the OpenCloud Android App.' or similar.

Suggested change
Tutorials about creating shares the OpenCloud Android App.
Tutorials about creating shares in the OpenCloud Android App.

Copilot uses AI. Check for mistakes.
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.

1 participant