[extension/storage/filestorage] Document how to read files created by the file_storage extension

[ycombinator]

Description:

This PR adds documentation explaining how to read the contents of files created by the file_storage extension.

Link to tracking Issue:

• Related to [extension/storage/filestorage] Document structure of local file storage files #30970
• Follow up to [receiver/filelog] Add documentation about contents of the offset tracking file #31886 (comment)

[atoulme]

I'm not sure about this. Are you trying to achieve a particular functionality or achieve a use case such as troubleshooting?

[atoulme]

OK, I have read the associated issue. Would you mind framing this as a troubleshooting solution?

[djaglowski]

Can we add a note that this strategy is subject to change.

The context here is that the underlying storage mechanism, aside from being a file, is not part of an API which we have ever guaranteed. Some suggestions have been made in the past to evaluate other key/value stores which may be more performant than the bbolt one we currently use. If we ever change, we would of course have to ensure migration is possible for some time, but ultimately we should be careful not to appear locked into the implementation.

[ycombinator]

Added in 4a32823b11.

[tiffany76]

Looks good from a documentation perspective.

[tiffany76]

One small change to eliminate redundancy. Otherwise, LGTM.