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

Update documentation, clean up package level documentation #173

Merged
merged 3 commits into from
Apr 28, 2020
Merged

Conversation

mwoss
Copy link
Member

@mwoss mwoss commented Apr 25, 2020

Few things changes since we start maintaining this library, so let's update docs.
This PR also should improve go report cards.

Btw. I removed package docs from decimal-go and rounding modules to improve godoc. Should I transfer those docs to decimal module or just remove it?

@mwoss mwoss requested a review from njason April 25, 2020 23:48
// Only operations are assign and (binary) left/right shift.
// Can do binary floating point in multiprecision decimal precisely
// because 2 divides 10; cannot do decimal floating point
// in multiprecision binary precisely.
package decimal
Copy link
Member

Choose a reason for hiding this comment

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

I think just adding an extra newline will omit the comments from godoc: Comments that are not adjacent to a top-level declaration are omitted from godoc's output https://blog.golang.org/godoc

It would be good to keep the comments in this file and rounding.go and not have them show up in godoc if we can

Copy link
Member Author

Choose a reason for hiding this comment

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

Great, I had no idea about that. I will fix it after work. :3

@mwoss
Copy link
Member Author

mwoss commented Apr 27, 2020

Yes, you were right Jason, adding new line was enough, godoc is not rendering those docs. Checked locally.

@njason njason merged commit 480f653 into master Apr 28, 2020
@njason njason deleted the doc-update branch April 28, 2020 02:35
fairyhunter13 added a commit to fairyhunter13/decimal that referenced this pull request Jul 12, 2020
…g#173)

* Update documentation, clean up package level documentation
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants