file system cache doc change

[MehulBatra]

Description

File system cache document change on optional fields

Additional context and related issues

As a developer when we try to enable caching, we face errors for setting options and try to look through it via logs what went wrong, if we could specify proactively that would make things easier.

Release notes

(*) This is not user-visible or is docs only, and no release notes are required. ( ) Release notes are required. Please propose a release note for me. ( ) Release notes are required, with the following suggested text:

# Section
* Fix some things. ({issue}`issuenumber`)

[cla-bot[bot]]

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

[mosabua]

Also update commit message to follow https://cbea.ms/git-commit/

[mosabua]

I chatted with some other writers on the team - for now we do not want to use () or italics for the required and optional terms since it does not provide much additional benefit but introduces an inconsistency with all the other docs.

[MehulBatra]

I chatted with some other writers on the team - for now we do not want to use () or italics for the required and optional terms since it does not provide much additional benefit but introduces an inconsistency with all the other docs.

@mosabua I picked up the idea of () from referring to the Trino Kubernetes docs itself, I found it quite clear as it was explicitly marked optional and caught my attention.

[cla-bot[bot]]

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

[cla-bot[bot]]

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

[cla-bot[bot]]

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

[cla-bot[bot]]

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

[mosabua]

I chatted with some other writers on the team - for now we do not want to use () or italics for the required and optional terms since it does not provide much additional benefit but introduces an inconsistency with all the other docs.

@mosabua I picked up the idea of () from referring to the Trino Kubernetes docs itself, I found it quite clear as it was explicitly marked optional and caught my attention.

Hm .. interesting .. I am not sure but to keep it simple I would suggest not to do that for now .. we can revisit for the complete docs or maybe take it out in the k8s docs.

[mosabua]

Also please squash commits and update commit message and submit CLA.

[MehulBatra]

Also please squash commits and update commit message and submit CLA.

CLA I have already submitted via email, changing the commit message and squashing it!

[cla-bot[bot]]

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

[cla-bot[bot]]

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

[mosabua]

Please fix wrapping to 80 character columns while we wait for CLA processing

[cla-bot[bot]]

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

[MehulBatra]

@mosabua @martint when can we expect the cla to be processed, thank you! Please do let me know if anything is missing from my end.

[github-actions[bot]]

This pull request has gone a while without any activity. Tagging the Trino developer relations team: @bitsondatadev @colebow @mosabua

[mosabua]

@cla-bot check

[cla-bot[bot]]

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

[cla-bot[bot]]

The cla-bot has been summoned, and re-checked this pull request!

[mosabua]

I just recently fixed something else in this section so you will have to rebse @MehulBatra .. sorry. CLA processing will happen soon.

[mosabua]

@cla-bot check

[cla-bot[bot]]

Thank you for your pull request and welcome to the Trino community. We require contributors to sign our Contributor License Agreement, and we don't seem to have you on file. Continue to work with us on the review and improvements in this PR, and submit the signed CLA to [email protected]. Photos, scans, or digitally-signed PDF files are all suitable. Processing may take a few days. The CLA needs to be on file before we merge your changes. For more information, see https://github.com/trinodb/cla

[cla-bot[bot]]

The cla-bot has been summoned, and re-checked this pull request!

[mosabua]

@MehulBatra CLA was processed now, seems like your git or github config is not using the right email and CLA bot verification is not working, also please rebase and resolve conflict.

Once all is good please ping me and I will review again and merge.

[github-actions[bot]]

This pull request has gone a while without any activity. Tagging the Trino developer relations team: @bitsondatadev @colebow @mosabua

[MehulBatra]

I am still working on it to get CLA resolved

[github-actions[bot]]

This pull request has gone a while without any activity. Tagging the Trino developer relations team: @bitsondatadev @colebow @mosabua

[mosabua]

Please

[mosabua]

I think all concerns are already addressed .. if not please reopen this PR and rebase, or send a new PR.