Cloud Files Addon: Documentation Issue

[jcogs-design]

Description of the problem
Not sure where this would / should go - so putting it here in hope that someone can put it in the right place.

The documentation for the R2 Cloud File adapter needs some clarification.

In "Step 3: Configure ExpressionEngine" - step 8 says:

Specify a Url to use as the base when generating links to files in the bucket.

Cloudflare itself provides links to the bucket (e.g. via "Public R2.dev Bucket URL") that can be copied, and with these types of URLs included you can upload files to the R2 folder. But when you try to view the files within the File system you don't get to see any images.

It turns out this is because while ExpressionEngine apparently automatically adds the path specified in Step 7 to the URL when uploading files ("path inside your bucket where the directory should store files and folders") since these files stored in the bucket are located within this path. However ExpressionEngine does not appear to similarly add the path to the URL when displaying files / generating links to the files. To get these links to work you need to append the "path" from step 7 to the end of the URL from step 8.

This is ambiguous behaviour about whether this path should be added or not - it would help if the documentation made clear that the path needs to be appended to the url to the bucket.

A better solution would probably be for ExpressionEngine to append the step 7 path automatically when generating links to images in the bucket ... but I guess that's unlikely (since this cloud files code appears to have been around for some long time).