Dispel NextCloud News ambiguities #139

Closed
opened 5 years ago by jking · 1 comments
jking commented 5 years ago
Owner

The README file lists several unknown or unclear behaviours in the reference NCNv1 implementation, namely:

  • NCN specifies that GET parameters are treated "the same" as request body parameters; it does not specify what to do in cases where they conflict
  • JSON is preferred unconditionally
  • NCN does not define validity of folder and names other than to specify that the empty string is invalid
  • Any folder name other than the empty string appears to be accepted
  • NCN does not specify a return code for bulk-marking operations without a newestItemId provided
  • The operation fails silently
  • NCN does not specify what should be done when creating a feed in a folder which does not exist
  • The feed is created, but is inaccessible until moved to a real folder
  • NCN does not specify what should be done when moving a feed to a folder which does not exist
  • The feed becomes inaccessible until moved to a real folder
  • NCN does not specify what should be done when renaming a feed to an invalid title, nor what constitutes an invalid title
  • Feed titles are unrestricted

The actual behaviour of NextCloud News (or, in some cases, NextCloud at large), should be tested and The Arsse made to behave the same.

The README file lists several unknown or unclear behaviours in the reference NCNv1 implementation, namely: - NCN specifies that GET parameters are treated "the same" as request body parameters; it does not specify what to do in cases where they conflict - JSON is preferred unconditionally - NCN does not define validity of folder and names other than to specify that the empty string is invalid - Any folder name other than the empty string appears to be accepted - NCN does not specify a return code for bulk-marking operations without a `newestItemId` provided - The operation fails silently - NCN does not specify what should be done when creating a feed in a folder which does not exist - The feed is created, but is inaccessible until moved to a real folder - NCN does not specify what should be done when moving a feed to a folder which does not exist - The feed becomes inaccessible until moved to a real folder - NCN does not specify what should be done when renaming a feed to an invalid title, nor what constitutes an invalid title - Feed titles are unrestricted The actual behaviour of NextCloud News (or, in some cases, NextCloud at large), should be tested and The Arsse made to behave the same.
jking added this to the 0.5.0 milestone 5 years ago
jking added the
trivial
label 5 years ago
Poster
Owner

As some of the tested behaviour is nonsensical (viz. disappearing feeds) and other differences actually helpful (e.g. silently failing is bad, whitespace-only names leads to odd results), only the first point will result in a change in behaviour in The Arsse.

As some of the tested behaviour is nonsensical (viz. disappearing feeds) and other differences actually helpful (e.g. silently failing is bad, whitespace-only names leads to odd results), only the first point will result in a change in behaviour in The Arsse.
jking closed this issue 5 years ago
Sign in to join this conversation.
No Milestone
No Assignees
1 Participants
Notifications
Due Date

No due date set.

Dependencies

This issue currently doesn't have any dependencies.

Loading…
There is no content yet.