Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

swagger.yaml edits for liquidity module #356

Merged
merged 3 commits into from
May 25, 2021
Merged

Conversation

barriebyron
Copy link
Contributor

Description

swagger.yaml edits for liquidity module

question: do we want a message description for block heights to be "is" or "was"
in this PR, I am suggesting to use present tense (although I was tempted to use the past tense, I don't know enough yet to make a firm recommendation)

I think that we are recording the block height "when this message was appended" ??

title: block height when this message is appended to the batch

closes: part of #217

Before we can merge this PR, please make sure that all the following items have been
checked off. If any of the checklist items are not applicable, please leave them but
write a little note why.

  • Targeted PR against correct branch (see CONTRIBUTING.md)
  • Linked to Github issue with discussion and accepted design OR link to spec that describes this work.
  • Code follows the module structure standards.
  • Wrote unit and integration tests
  • Updated relevant documentation (docs/) or specification (x/<module>/spec/)
  • Added relevant godoc comments.
  • Added a relevant changelog entry to the Unreleased section in CHANGELOG.md
  • Re-reviewed Files changed in the Github PR explorer
  • Review Codecov Report in the comment section below once CI passes

@barriebyron barriebyron self-assigned this May 20, 2021
@barriebyron barriebyron requested review from dongsam and jaybxyz May 20, 2021 18:25
@codecov
Copy link

codecov bot commented May 20, 2021

Codecov Report

Merging #356 (225379d) into develop (5eba16e) will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@           Coverage Diff            @@
##           develop     #356   +/-   ##
========================================
  Coverage    83.26%   83.26%           
========================================
  Files           20       20           
  Lines         2247     2247           
========================================
  Hits          1871     1871           
  Misses         207      207           
  Partials       169      169           

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 5eba16e...225379d. Read the comment docs.

Copy link
Contributor

@jaybxyz jaybxyz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM other than the question I commented if we should end sentence with a dot for the title section.

@@ -32,7 +32,7 @@ paths:
The id of the pool_type to use as pool_type_id for
pool creation.

Only pool-type-id 1 is supported
Only pool-type-id 1 is supported.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If the sentence should end with a dot, then we should maybe put a dot in the other sentences?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for noticing @kogisin

  • for title, the style is not to use punctuation (dot) at the end of the sentence
    (our titles are probably longer than appropriate, I need to learn more)
  • for description, we do need punctuation at the end of complete sentences

@barriebyron barriebyron requested a review from jaybxyz May 24, 2021 20:12
@barriebyron
Copy link
Contributor Author

@kogisin can you take a look at the minor changes I just introduced, so make sure all is accurate and as expected?

@jaybxyz jaybxyz added the documentation Improvements or additions to documentation label May 25, 2021
Copy link
Contributor

@jaybxyz jaybxyz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@barriebyron barriebyron merged commit f5458e5 into develop May 25, 2021
@barriebyron barriebyron deleted the swagger-pool-docs branch May 25, 2021 19:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants