docs: Liquidity godoc QA

[dongsam]

Description

#176
It is PR to get the liquidityd godoc QA suggestions based on the sources

Found 3 files that looked like they might need edits, see those changes staged in this PR.
@dongsam can you provide the file links for each file, from the correct repo, so I can address those edits here?
all help appreciated.

For this request:
https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/keeper#pkg-functions
https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/keeper#pkg-types
https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/types#pkg-functions
https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/types#pkg-types
https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/simulation#pkg-functions

what are the specific files that I can open and edit? please and thank you, maybe @kogisin knows?

---historical

temporarily remove and revert to create diff for review

ref

• https://blog.golang.org/godoc
• https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4

[codecov]

Codecov Report

❌ Patch coverage is 91.37931% with 5 lines in your changes missing coverage. Please review.
✅ Project coverage is 83.26%. Comparing base (ee1aa8b) to head (df93550).
⚠️ Report is 183 commits behind head on develop.

Files with missing lines	Patch %	Lines
x/liquidity/keeper/invariants.go	76.47%	1 Missing and 3 partials ⚠️
x/liquidity/keeper/liquidity_pool.go	96.00%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #217      +/-   ##
===========================================
+ Coverage    82.93%   83.26%   +0.33%     
===========================================
  Files           20       20              
  Lines         2215     2247      +32     
===========================================
+ Hits          1837     1871      +34     
+ Misses         208      207       -1     
+ Partials       170      169       -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[barriebyron]

@dongsam these go docs are autogenerated, right? let's focus on the CLI, swagger, and markdown docs and when that content is updated then this autogenerated go doc content will also be updated, right? You can move in the suggested changes from the CLI, swagger, and so on here. Let me know if you have questions. I'm here to help!

[dongsam]

@dongsam these go docs are autogenerated, right? let's focus on the CLI, swagger, and markdown docs and when that content is updated then this autogenerated go doc content will also be updated, right? You can move in the suggested changes from the CLI, swagger, and so on here. Let me know if you have questions. I'm here to help!

@barriebyron You're right, go docs are autogenerated, markdown docs and *.pb.go, *pb.gw.go files autogenerated by *.proto will also be updated
So I think it would be good to see the parts except for swagger, markdown, cli, and tx in the PR.

for example, https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/keeper#Keeper.ExecutePoolBatch is autogenerated from

liquidity/x/liquidity/keeper/batch.go

Lines 81 to 83 in fb15225

	// In case of deposit, withdraw, and swap msgs, unlike other normal tx msgs,
	// collect them in the liquidity pool batch and perform an execution once at the endblock to calculate and use the universal price.
	func (k Keeper) ExecutePoolBatch(ctx sdk.Context) {

As above, it would be good to look at the parts where each func, type structure has a comment.
It mainly exists below

• https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/keeper#pkg-functions
• https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/keeper#pkg-types
• https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/types#pkg-functions
• https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/types#pkg-types
• https://pkg.go.dev/github.com/tendermint/liquidity@v1.2.4/x/liquidity/simulation#pkg-functions

[barriebyron]

I made editorial changes on 3 files, but I'm sure we have more. Approved this round, let me know what else needs my attention.