Skip to content

Commit 6cbcf69

Browse files
committed
Remove unneeded text
1 parent 8201278 commit 6cbcf69

File tree

2 files changed

+6
-15
lines changed

2 files changed

+6
-15
lines changed

content.mkd

+5-14
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44
**(This document is in work and has not been submitted yet.)**
55

6-
WebDAV-Push is intended as an additional tool to notify clients about updates in near time so that clients can refresh their views, perform synchronization etc.
6+
WebDAV-Push is intended as a tool for WebDAV {{RFC4918}} clients to get notified about updates in collections in near time so that they can refresh their views, perform synchronization etc.
77

88
A client SHOULD NOT rely solely on WebDAV-Push, so it should also perform regular polling like when WebDAV-Push is not available. However if WebDAV-Push is available, the polling frequency can be significantly reduced.
99

@@ -199,21 +199,12 @@ Example: `<P:topic>O7M1nQ7cKkKTKsoS_j6Z3w</P:topic>`
199199

200200
## Subscription Registration
201201

202-
How to subscribe to collections on the WebDAV server. Required information:
203-
204-
- Collection to be subscribed
205-
- Push transport, including transport-specific details
206-
- Web Push: push resource URL
207-
- Expiration? how long by default, min/max (24 h), server decides (and can impose limits)
208-
- (End-to-end-encryption? Or should it be defined per transport?)
209-
210-
[^todo] By now, only updates in direct members (equals `Depth: 1`) are sent. Maybe it could be specified that servers can send one notification per path segment? Implications?
211-
212-
To subscribe to a collection, the client sends a POST request with
213-
`Content-Type: application/xml` to the collection it wants to subscribe. The root XML element of the XML body is `push-register` in the WebDAV-Push name space (`DAV:Push`) and can be used to distinguish between a WebDAV-Push and other requests.
202+
To subscribe to a collection, the client sends a POST request with `Content-Type: application/xml` to the collection it wants to subscribe. The root XML element of the XML body is `push-register` in the WebDAV-Push name space (`DAV:Push`) and can be used to distinguish between a WebDAV-Push and other requests.
214203

215204
The `push-register` element contains (exactly/at least?) one `subscription` element, which contains all information the server needs to send a push message.
216205

206+
[^todo] By now, only data updates of the collection itself and in direct members (equals `Depth: 1`) are sent. Maybe it could be specified that servers can send one notification per path segment? Implications?
207+
217208
Allowed response codes:
218209

219210
* 201 if the subscription was registered and the server wants to return additional information, like encryption details that are only valid for this subscription. Details have to be specified by the particular transport definition.
@@ -336,7 +327,7 @@ The push message body contains a `{DAV:propstat}` element with
336327
* a `{DAV:}prop` element that
337328

338329
* MUST contain the `topic` of the affected collection so that the client can identify it without doubt,
339-
* SHOULD contain a `{DAV:}sync-token` element (when available) to allow a client to ignore the push message (and for instance, skip synchronization) when it already knows the latest state,
330+
* SHOULD contain a `{DAV:}sync-token` element (when available) to allow a client to ignore the push message when it already knows the latest state,
340331
* MUST NOT contain elements with sensitive data (unless message encryption is used).
341332

342333
When the `{DAV:}status` element is present, it indicates a change of the status of the collection itself (and not its members). In this case, clients SHOULD check and process the relevant properties of the collection. Status code 404 or 410 is used to indicate that the collection has been removed.

webdav-push.mkd

+1-1
Original file line numberDiff line numberDiff line change
@@ -27,14 +27,14 @@ author:
2727

2828
normative:
2929
RFC4918:
30+
RFC6578:
3031
RFC8030:
3132
RFC8291:
3233
RFC8292:
3334
RFC9110:
3435
RFC9111:
3536

3637
informative:
37-
RFC6578:
3838
UnifiedPush:
3939
title: UnifiedPush
4040
target: https://unifiedpush.org

0 commit comments

Comments
 (0)