Rewrite of finisher_api Godocs

[bruc3mackenzi3]

• Do only one thing
• Non breaking API changes
• Tested

What did this pull request do?

This PR contains a general rewrite of the method Godocs in finisher_api.go, including:

• Fix grammar & spelling, improve wording
• Employ consistent language across all documentation
• Explicitly reference method parameters in comments
• Fill gaps in explanations
  • I've used existing documentation from gorm.io when available
  • when not available I've done my best to write my own description of what the method does
• limit line length to 120 chars

User Case Description

This will improve usability of GORM by providing enhanced inline documentation

[bruc3mackenzi3]

@jinzhu please give this PR a review when you get the chance.

Are you interested in receiving more contributions like this? If the GORM project is interested in improvements to documentation I would like to continue contributing.

[jinzhu]

Hello @bruc3mackenzi3

Yeah, which is really helpful, thank you for the awesome work.

If possible, you can also contribute to this repo github.com/go-gorm/gorm.io, which used to host website https://gorm.io

[bruc3mackenzi3]

Thanks for your review & approval, Jinzhu. Is there anything I can do to have my PRs reviewed sooner? A faster turnaround on submitted PRs will help facilitate more contributions to the GORM project. I posted a Discussion about it here as well.