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 readme #195

Merged
merged 13 commits into from
Oct 17, 2023
Merged

Update readme #195

merged 13 commits into from
Oct 17, 2023

Conversation

MerlinEgalite
Copy link
Contributor

Fixes #100

Questions:

  1. Should we add the specification of MM?
  2. Should we add the description of the different roles?

@MerlinEgalite MerlinEgalite requested review from a team, Rubilmax and Jean-Grimal and removed request for a team October 12, 2023 12:30
@Jean-Grimal
Copy link
Contributor

  1. Should we add the specification of MM?
  2. Should we add the description of the different roles?

I think we should because if I'm not mistaken there won't be any whitepaper. So I think we should have these informations in the Readme

@openzeppelin-code
Copy link

Update readme

Generated at commit: 5b3864142302de841989426979b298b2dbb1e1ef

🚨 Vulnerabilities Summary

Process Issues Results
Contract Inspector note
low
Total
22
7
29
Dependency Checker Total 0

For more details view the full report in OpenZeppelin Code

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
Co-authored-by: Jean-Grimal <[email protected]>
Signed-off-by: Merlin Egalite <[email protected]>
README.md Outdated Show resolved Hide resolved
Co-authored-by: Jean-Grimal <[email protected]>
Signed-off-by: Merlin Egalite <[email protected]>
Copy link
Contributor

@Rubilmax Rubilmax left a comment

Choose a reason for hiding this comment

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

I'm surprised most of the doc does not correspond exactly to https://www.notion.so/morpho-labs/Morpho-Blue-Documentation-Hub-Confidential-67b037dd32eb479483f9d8489074f0a2?pvs=4#054dc16f414049939e00a4f17cb917b4

Why are we writing something different here?

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@MerlinEgalite
Copy link
Contributor Author

MerlinEgalite commented Oct 16, 2023

I'm surprised most of the doc does not correspond exactly to https://www.notion.so/morpho-labs/Morpho-Blue-Documentation-Hub-Confidential-67b037dd32eb479483f9d8489074f0a2?pvs=4#054dc16f414049939e00a4f17cb917b4

Why are we writing something different here?

I agree we can harmonize, but in this case we may want to point to the github in the notion no? Else it's a nightmare to maintain

Co-authored-by: Romain Milon <[email protected]>
Signed-off-by: Merlin Egalite <[email protected]>
@Rubilmax
Copy link
Contributor

I agree we can harmonize, but in this case we may want to point to the github in the notion no? Else it's a nightmare to maintain

Definitely agree
But this documentation doesn't seem to be completed just yet. I'd wait for it to be published. Where is it expected to be published?

I think we should just go the other way around: have the README point to this documentation and perhaps add code references to clarify some points (though I don't see any dark corner)

@MerlinEgalite
Copy link
Contributor Author

Definitely agree But this documentation doesn't seem to be completed just yet. I'd wait for it to be published. Where is it expected to be published?

Are you talking about the notion page?

I think we should just go the other way around: have the README point to this documentation and perhaps add code references to clarify some points (though I don't see any dark corner)

Well, I'm not sure. When you modify the code it's way easier to keep in sync the README than the Notion.

@Rubilmax
Copy link
Contributor

Are you talking about the notion page?

Yes

Well, I'm not sure. When you modify the code it's way easier to keep in sync the README than the Notion.

Yes and conversely: modifying the documentation is easier on Notion (or any appropriate tool) than on GitHub
And from now, it seems the documentation is more incline to be changed than the code or its specs

I don't really care in the end except having a single place where the documentation is written

@MerlinEgalite
Copy link
Contributor Author

Let's discuss during today's call

Co-authored-by: Romain Milon <[email protected]>
Signed-off-by: Merlin Egalite <[email protected]>
README.md Show resolved Hide resolved
A maximum of 30 markets can be enabled on a given MetaMorpho vault.
Each market has a supply cap configured onchain that guarantees lenders a maximum absolute exposure to the specific market.

There are 4 different roles for a MetaMorpho vault (owner, curator, guardian & allocators).
Copy link
Contributor

Choose a reason for hiding this comment

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

There is also the rewards recipient, and the fee recipient, I think we should list them and explain those roles too

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hmm they cannot trigger any function more than a normal user, should we add them still?

Copy link
Contributor

Choose a reason for hiding this comment

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

Just a few sentences would be nice. For example

Suggested change
There are 4 different roles for a MetaMorpho vault (owner, curator, guardian & allocators).
The fee recipient is the recipient of the fee generated from using the vault.
The rewards recipient is the recipient of the rewards attributed to users of Morpho Blue markets, which can then be redistributed to users of the vault.
On top of those roles there are 4 different roles for a MetaMorpho vault : owner, curator, guardian & allocators.

README.md Outdated Show resolved Hide resolved

Run forge tests: `yarn test:forge`

Run hardhat tests: `yarn test:hardhat`
Copy link
Contributor

Choose a reason for hiding this comment

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

Those are gas tests right ? We should explain that if it's the case, otherwise we wonder why we use both hardhat and forge

Copy link
Contributor Author

Choose a reason for hiding this comment

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

We should do the same in blue then but there was that comment: morpho-org/morpho-blue#523 (comment)

Copy link
Contributor

Choose a reason for hiding this comment

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

Ok I didn't know it was removed, it's fine if we want to not add that comment

Co-authored-by: Jean-Grimal <[email protected]>
Co-authored-by: Quentin Garchery <[email protected]>
Signed-off-by: Merlin Egalite <[email protected]>
@MerlinEgalite MerlinEgalite merged commit 64f9880 into main Oct 17, 2023
@MerlinEgalite MerlinEgalite deleted the docs/update-readme branch October 17, 2023 15:26
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.

Update README
4 participants