Overhaul and Cleanup of the README File

[eric-pSAP]

This is meant to add more information as well as clarify current information. Also want to align with the README of the Java version of Attachments. Steps remaining:

• Finalize structure and sections
  • Removing Java-specific sections and information
• Confirm and clarify details
• Add in links to sources

This initial change should make the rest of the editing process more streamlined

[eric-pSAP]

Transferring old notes

[lisajulia]

Thanks @eric-pSAP!

Can you please double check if the following statements are true:

• when running the application completely locally (not in hybrid mode), the attachements are stored locally in the database
• when running the application in production, an object store binding is needed
• to test with an object store binding, you need a such an object store binding, typically one provisioned through SAP BTP, to test you use a hybrid setup
• currently, only the AWS-S3 object store is supported

I'm pretty sure, the above are all true.

Can you also doublecheck:

• you can turn off the malware scanner by setting "attachments": {"scan": false}
• even if malware scan is turned off: the file size restriction "max 400 MB" is still active
• doublecheck the scan status codes please as well

And then make sure these things are reflected in the README :) - I think I've covered the spots concerning the object store...

Thanks a lot!!!

[eric-pSAP]

Can you also doublecheck:

• you can turn off the malware scanner by setting "attachments": {"scan": false}
• even if malware scan is turned off: the file size restriction "max 400 MB" is still active
• doublecheck the scan status codes please as well

1. Yes you can, and it works
2. File size is still restricted even with scanner off
3. Status codes are indeed correct (although I have not seen "infected" in action before)

[lisajulia]

@eric-pSAP: We might want to ask for a review from @renejeglinsky as well!

@renejeglinsky: We try to align the documentation of https://github.com/cap-java/cds-feature-attachments and this attachments-node-plugin. If you have time, could you also have a look at this! Thanks!