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

Add modules.md #401

Closed
wants to merge 2 commits into from
Closed

Add modules.md #401

wants to merge 2 commits into from

Conversation

junha1
Copy link
Member

@junha1 junha1 commented Mar 14, 2023

No description provided.

docs/modules.md Outdated Show resolved Hide resolved
The module may also have another storage (other than DMS) to store its
internal states, which can deduce the set of messages to be broadcasted upon
the `flush`() operation.
- In the `update()` operation, the module reads the message stored in DMS and
Copy link
Contributor

Choose a reason for hiding this comment

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

Ditto.

Copy link
Contributor

@TomTaehoonKim TomTaehoonKim Mar 15, 2023

Choose a reason for hiding this comment

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

Plus, does the module read a single message during the update() operation? If not, please fix to messages.

- During each operation, the module may store some messages to its local DMS.
- In the `flush()` operation, the module stores all the messages it wants to
broadcast. These messages may or may not have been stored by other operations.
The module may also have another storage (other than DMS) to store its
Copy link
Contributor

Choose a reason for hiding this comment

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

How is this done?

Copy link
Member Author

Choose a reason for hiding this comment

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

What do you mean?

Comment on lines +38 to +52
## Repository

TODO

## Governance

TODO

## Consensus

TODO

## Chat

TODO
Copy link
Contributor

Choose a reason for hiding this comment

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

How about leaving documents under each module's repository and putting a link to it above in Modules section?

Copy link
Member Author

Choose a reason for hiding this comment

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

I'm not sure. Let's think about after we got actual contents

Co-authored-by: Taehoon Tom Kim <kim.taehoon@snu.ac.kr>
2. Governance: This module manages a node's client in the p2p governance voting
protocol.
3. Consensus: This module manages a node's state machine of the BFT algorithm
(Vetomint).
Copy link
Contributor

@f2koi f2koi Mar 15, 2023

Choose a reason for hiding this comment

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

Suggested change
(Vetomint).
([Vetomint](https://github.com/postech-dao/simperby/blob/main/docs/vetomint.md)).

I think it would be nice to have a link.

@junha1
Copy link
Member Author

junha1 commented Apr 4, 2023

After some more consideration while designing the interface, I think this description is slightly outdated and I need another way to explain the structure. Let me revisit this issue soon.

@junha1 junha1 closed this Apr 4, 2023
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.

5 participants