Explicit statement on sub-project scoping

[shizhMSFT]

The question about scope of each sub-project continues to come up. I'm suggesting the readme can define the scope:
"The oras-dotnet repo is scoped at implementing a dotnet version of ORAS functionality. "

The interesting thing that came up with the oras-py implementation is whether each library is following an implementation of a common spec? What's the reference for each library?
For now, It's probably ok to just say the above.

Originally posted by @SteveLasker in oras-project/oras-dotnet#2 (comment)

[shizhMSFT]

Do we need to have the following explicit statement for all repositories matching the pattern oras-<language>?

The oras-<language> repo is scoped at implementing a <language> version of ORAS library functionality.

I think it is redundant to have the explicit statement since the project name "ORAS <language> library" already states it is an oras library for a particular programming language.

[shizhMSFT]

The interesting thing that came up with the oras-py implementation is whether each library is following an implementation of a common spec?

All ORAS libraries should follow https://oras.land/client_libraries/.
Since libraries are language specific, we can only have common high-level designs.

What's the reference for each library?

Since libraries are language specific, references will be available on the language specific website. A link should be added to the README.md correspondingly. Language specific tutorials should be updated to https://oras.land/.

[SteveLasker]

Thanks @shizhMSFT for opening this.
I agree, for the language libraries, the scope is fairly defined. WIthout a specific spec, common across all libraries, we need some reference. If https://oras.land/client_libraries/ is the reference, that's great to call out. This way, someone wanting to implement a library will know the target.

For other sub-projects may be a bit broader, or different. Having each sub-project define it's scope is goal. Not too much, not too little, juuuust right.

[TerryHowe]

Just a paragraph in the README with goals/non-goals maybe?