method naming conventions

[shanejonas]

Is your feature request related to a problem? Please describe.
As a developer, i'd like clear naming conventions to remove unnecessary variation.

I've also outlined my thoughts around how this naming and it being a foundational layer to get a RESTful style interface with JSON-RPC here.

gRPC's naming conventions:

https://cloud.google.com/apis/design/naming_convention#method_names

Carefully consider use of names that may conflict with keywords in common programming languages. Such names may be used but will likely trigger additional scrutiny during API review. Use them judiciously and sparingly.

VerbNoun

The verb portion of the method name should use the imperative mood, which is for orders or commands rather than the indicative mood which is for questions.

[shanejonas]

From the article here.

Path to API Enlightenment - REST over JSON-RPC

Based on Richardson Maturity Model description of the different layers of REST APIs. But applied with OpenRPC in mind:

• Level 0 - Basic transport agnostic JSON-RPC API

• Level 1 - Break down complexity into multiple resources or services.

• Level 2 - Use a standard set of verbs and nouns removing unnecessary variation.

• Level 3 - Introduce service discovery and links via the OpenRPC interface definition, -providing a self-documenting protocol.

[shanejonas]

Another resource reinforcing naming with actionResource: the art of naming variables.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[BelfordZ]

@shanejonas is there something still to be done here?

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[shanejonas]

would be great to follow the naming conventions outlined here

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.