docs on buffer

[genofire]

i do not find the way the default values are setup.
but here is the documentation:
https://docs.fluentd.org/configuration/buffer-section

so maybe update that correctly based on then

[pepov]

Hey! Thanks you are right, that the definitions should reflect the actual state of the plugin, but there are a few things we have to consider:

1. Backwards compatibility
   We need to consider if any of these changes mean a breaking change in existing deployments

2. Using the plugin tag for setting defaults
   The plugin:"default:XY" tag should only be used in special situations. This is not very consistent throughout the code right now, but I would like to improve this.
   What the plugin:default tag does is it explicitly fills the value to something in the generated fluentd code. Now if that value is the same that fluentd would use if you would leave the field out, then what is the point of setting it?
   The point of the plugin:default is to set values that are different from what fluentd would set anyways. Of course we need to clearly articulate why this is needed.

In addition to this there are also other things we need to take care of, when making changes around buffer settings, see for example:
#1099
#732

I'm going to further comment on this PR soon, but for now I need to ask for your patience.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions!