Review Address.md

[cduangprom]

First review of these files, need to clarify some of the content. Questions in comments.

[boolafish]

I haven’t fully take into the PR yet, but all doc here is auto generated via code document. And sadly this Address file is actually from open zeppelin which we don’t have control. ( we use it as dependency and the doc gen tool pulled that in too)

[cduangprom]

@boolafish I'm aware the doc is auto-generated, that's fine, but can the output seen in the .md file be edited? Gerhard requested I review these files for language and formatting. He said I could edit and create the PR. The first PR is exploratory, thus my questions. Are the doc files in this repo the final output to show to audience?

[cduangprom]

Somehow the pr closed with my last comment

[cduangprom]

@boolafish Gerhard has just advised I should take a look at source files instead, in the code at https://github.com/omisego/plasma-contracts/tree/master/plasma_framework/contracts/src.

[boolafish]

Oh yeah, if any change you’d like to make should be on source code directly. Just sadly the file edited in this PR it is out of our control

[cduangprom]

@boolafish latest natspec format is now v0.5.12. Will you continue with v0.5.11 or will the auto-generate automatically apply v0.5.12 when you next generate docs. I'm sure minor differences only just want to check

[boolafish]

I am guessing you means our solidity version. My plan is to keep 0.5.11 for a while and move to 0.5.12 before audit. (Assuming we prefer latest version for audit) See previous discussion here: #328 (comment)

I doubt it would have any impact on the doc here, but will make sure we re-generate the doc again.