Add details about AudioEffectCapture.clear_buffer() and get_buffer()

[mutantbob]

This adds a few sentences to the AudioEffectCapture.xml documentation with helpful notes about the clear_buffer() and get_buffer() functions.

It does not fully address issue godotengine/godot-docs#8326 , but should be useful to new users.

[YuriSizov]

When you make further changes, could you please squash your commits into one? Make sure that the final commit has a short but descriptive message (the title of this PR is a good option). See this documentation, if you need help with squashing.

[AThousandShips]

Your commit seems not to be linked to your GitHub account. See: Why are my commits linked to the wrong user? for more info.

[mutantbob]

@YuriSizov it started out as a single commit, but several modifications were suggested in the pull request and a I accepted them. The github UI did not offer me a squash option.

[AThousandShips]

Please see the documentation above, you need to use the command line

I can help you if you are not able to do so yourself

[AThousandShips]

You changed previous commits incorrectly, you need to remove those, this is because you resigned them with your own user

You should also start your commit with a capital letter

[AThousandShips]

To drop those commits you need to do git rebase -i master and then put drop in front of the commits you shouldn't include

[fire]

@lyuma if your interested

[Mickeon]

The details look good on paper but we need feedback from audio-savvy developers.

[fire]

The first section looks ok to me, I haven't checked the math for get_buffer. Will ping @lyuma

[akien-mga]

I pushed a doc update as suggested.

@mutantbob For the record, your commit seems not to be linked to your GitHub account. See: Why are my commits linked to the wrong user? for more info.

[akien-mga]

Thanks! And congrats for your first merged Godot contribution 🎉