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

blockchain app content #335

Merged
merged 3 commits into from
Aug 15, 2018
Merged

blockchain app content #335

merged 3 commits into from
Aug 15, 2018

Conversation

andogro
Copy link
Contributor

@andogro andogro commented Aug 8, 2018

Includes typo fixes, README modifications and content additions for some of the blockchain modules. I will continue with this process but wanted to update with incremental progress.

  • Need to add step by step instructions for main README debugging, current instructions do not produce a tangible result.
    -Blockchain.Bloom was missing documentation - I added some related information from yellow paper but unsure if it covers module processes
  • Also added documentation for blockchain.ex as a brief summary of other mods. May make more sense to add @moduledoc File.read!("README.md") for these top level files?

@ghost ghost assigned andogro Aug 8, 2018
@ghost ghost added the status: in progress label Aug 8, 2018
@andogro andogro requested a review from masonforest August 10, 2018 15:52
Copy link
Contributor

@germsvel germsvel left a comment

Choose a reason for hiding this comment

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

I have a few suggestions, but this looks good to me otherwise

@@ -1,5 +1,5 @@
defmodule Blockchain.Application do
# See http://elixir-lang.org/docs/stable/elixir/Application.html
# See https://elixir-lang.org/getting-started/mix-otp/supervisor-and-application.html
Copy link
Contributor

Choose a reason for hiding this comment

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

I think we can remove the comments from this module. They are auto-generated when created the mix project.

@@ -32,7 +32,7 @@ defmodule Blockchain.Application do
# worker(Blockchain.Worker, [arg1, arg2, arg3]),
]

# See http://elixir-lang.org/docs/stable/elixir/Supervisor.html
# See https://elixir-lang.org/getting-started/mix-otp/supervisor-and-application.html
Copy link
Contributor

Choose a reason for hiding this comment

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

Same with this one. I think we should remove them since they're auto-generated.

@moduledoc """
When a block is generated or verified, the contract addresses and fields from the generated logs are added to a bloom filter. This is included in the block header.

_From Yellow Paper 4.3.1. Transaction Receipt_: The transaction receipt is a tuple of four items comprising the post-transaction state, R, the cumulative gas used in the block containing the transaction receipt as of immediately after the transaction has happened, Ru, the set of logs created through execution of the transaction, Rl and the Bloom filter composed from information in those logs, Rb:
Copy link
Contributor

Choose a reason for hiding this comment

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

What do you think about breaking this paragraph (and the previous one) into multiple lines? It makes it a bit hard to read like this.

Copy link
Contributor

Choose a reason for hiding this comment

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

I also noticed that this ends with Rb:. Is there supposed to be something after that or is the colon supposed to be a period?

@@ -1,4 +1,17 @@
defmodule Blockchain.Bloom do
@moduledoc """
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@ayrat555 I see you wrote a post on the bloom filter - adding any of those comments or examples to this file may be useful, or at least a link to the article. http://www.badykov.com/ethereum/2017/10/29/ethereum-bloom-filter/

Copy link
Member

Choose a reason for hiding this comment

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

@andogro good idea

@ayrat555
Copy link
Member

ayrat555 commented Aug 13, 2018

@andogro @germsvel @masonforest currently, credo check for required module documentations is turned off. should we turn it on?

https://github.com/poanetwork/mana/blob/master/.credo.exs#L89

@germsvel
Copy link
Contributor

@ayrat555 I think that would make sense.

@ayrat555
Copy link
Member

@andogro we should also delete old licenses from mix.exs files
https://github.com/poanetwork/mana/blob/master/apps/blockchain/mix.exs#L15

@andogro andogro merged commit 0559b20 into mana-ethereum:master Aug 15, 2018
@ghost ghost removed the status: in progress label Aug 15, 2018
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.

3 participants