Documented API update from RFC 0072

[mesemus]

Description

This PR contains documentation of API changes proposed in RFC 0072.

Checklist

Ticks in all boxes and 🟢 on all GitHub actions status checks are required to merge:

• I'm aware of the code of conduct.
• I've created logical separate commits and followed the commit message format.
• I've targeted the master branch.
• If this documentation change impacts the current release of InvenioRDM, I will backport it to the production branch following approval or indicate to a maintainer that it should be backported.

Reminder

By using GitHub, you have already agreed to the GitHub’s Terms of Service including that:

1. You license your contribution under the same terms as the current repository’s license.
2. You agree that you have the right to license your contribution under the current repository’s license.

[mesemus]

Connected pull requests:

RFC 0072
Implementation in invenio-records-resources
S3 multipart implementation
invenio-rdm-records - depends on this PR

[tmorrell]

Could you add in that file size and checksum are optional parameters?

[tmorrell]

This needs to be included in v13. There is a bit on the permissions that should be checked before merging.

[tmorrell]

I'm not sure these permissions have been implemented. It works out of the box for me without modifying permissions

[mesemus]

I will have a look at it today.

[fenekku]

Note that in upcoming "Reference" section refactor, File storage is going to be moved around/edited for clarity of audience and purpose. Currently it mixes REST API usage, with explanation of internals, with configuration for site administrators. You can separate those concerns out if you want, otherwise I will if that reorg lands after this PR.