Skip to content

docs(dev/WebDAV): expand and correct basic operations reference#14136

Merged
skjnldsv merged 4 commits into
masterfrom
jtr/docs-dev-webdav-basics
Apr 23, 2026
Merged

docs(dev/WebDAV): expand and correct basic operations reference#14136
skjnldsv merged 4 commits into
masterfrom
jtr/docs-dev-webdav-basics

Conversation

@joshtrichards
Copy link
Copy Markdown
Member

☑️ Resolves

Overhauls the WebDAV basic operations page in the developer manual.

New content:

  • Quick method/header cheat sheet table
  • Missing properties: nc:is-federated, nc:metadata_etag, nc:download-url-expiration, dynamic nc:metadata-*
  • X-Requested-With requirement for non-GET requests on public share endpoints
  • X-Hash: all option, OC-Checksum bulk upload validation behavior, X-NC-WebDAV-AutoMkcol availability note (NC 32+)
  • Shorthand zip/tar values for folder download accept parameter

Clarifications:

  • Renamed page: "Basic APIs" to "Basic File & Folder Operations"
  • Expanded intro with file path pattern and 2FA app-password guidance
  • Noted oc:permissions S/M flag stripping on public shares
  • Added URL-encoding reminder for query-parameter folder downloads
  • Added note distinguishing standard WebDAV vs Nextcloud-specific property namespaces

Changes:

  • Typos: "head" > "header", oc-favorite > oc:favorite, missing periods
  • Broken XML: corrected ocm namespace url syntax, fixed indentation and missing </d:propfind> closing tag
  • Self-closing tag syntax: nc:is-mount-root, nc:hidden
  • Improved the Supported properties table layout: column widths

🖼️ Screenshots

image

Copy link
Copy Markdown
Member

@provokateurin provokateurin left a comment

Choose a reason for hiding this comment

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

Looks good, but some of the tables are still not formatted correctly 🙈

@skjnldsv
Copy link
Copy Markdown
Member

@copilot, fix the tables that are not properly formatted

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 23, 2026

@copilot, fix the tables that are not properly formatted

Fixed in 1f149fb. The separator row between the "GET (file)" and "GET (dir)" rows in the method cheat sheet table had column 3 with 45 dashes instead of 46 (and column 4 with 62 instead of 61), causing misalignment with all other separator rows. The corresponding content rows for "GET (dir)" were also one character off.

Copilot AI requested a review from skjnldsv April 23, 2026 16:48
joshtrichards and others added 4 commits April 23, 2026 21:13
Signed-off-by: Josh <josh.t.richards@gmail.com>
Signed-off-by: Josh <josh.t.richards@gmail.com>
Signed-off-by: Josh Richards <josh.t.richards@gmail.com>
@skjnldsv skjnldsv force-pushed the jtr/docs-dev-webdav-basics branch from 1f149fb to a1a3e3c Compare April 23, 2026 19:13
@skjnldsv skjnldsv merged commit b2602c4 into master Apr 23, 2026
22 checks passed
@skjnldsv skjnldsv deleted the jtr/docs-dev-webdav-basics branch April 23, 2026 19:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants