As noted in #2831716-50: REST UI does not support "resource" granularity it is unclear what each choice really does. This needs some explanation.

Current text is

Here you can restrict which HTTP methods should this resource support. And within each method, the available serialization formats and authentication providers.

This needs to explain both Granuarity options.

  • Resource
  • Method

What about

Here you can restrict your resource configuration by either configuring the whole resource or configuring each method separately.

Configuring the whole resource you select which Methods all use the same Accepted request formats using the same Authentication providers.

Configuring by Method you can fine tune which method is using what Accepted request formatseach having their own Authentication providers.

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

clemens.tolboom created an issue. See original summary.

clemens.tolboom’s picture

I don't like the screen space used. Making it one line makes it harder to read. What should we do?

clemens.tolboom’s picture

clemens.tolboom’s picture

Wim Leers’s picture

We should make it more difficult to use method granularity, it should become the "advanced" way to configure REST resources.

clemens.tolboom’s picture

Not sure how to make it

More difficult

?

What about using 'By Resource' and 'By Method'

clemens.tolboom’s picture

Wim Leers’s picture

#6: we can do that by moving the "by method" configuration to a separate location, hidden behind an "Advanced" tab or something like that.

clemens.tolboom’s picture

Is the 'advanced' method discouraged then? Otherwise there is no value in hiding it I guess.

Wim Leers’s picture

Is the 'advanced' method discouraged then? Otherwise there is no value in hiding it I guess.

Yes. granularity: method is strongly discouraged, in favor of resource: granularity. This has been true since #2721595: Simplify REST configuration.

Wim Leers’s picture

Status: Needs review » Needs work
clemens.tolboom’s picture

Title: Add better description configuring a Method or Resource » Move granularity away into an 'Advanced' tab
clemens.tolboom’s picture