Conversation
gui1117
commented
Mar 21, 2019
- decl event support rust doc for RawEvent, so I moved docs accordingly
- improve decl_storage instance doc
srml/assets/src/lib.rs
Outdated
| /// circumstances that have happened that users, Dapps and/or chain explorers would find | ||
| /// interesting and otherwise difficult to detect. | ||
| decl_event!( | ||
| /// An event in this module. |
There was a problem hiding this comment.
Let's agree on one correct comment to go here, before the pub enum Event and use it for each module. I think "/// Events for this module." would be ok.
There was a problem hiding this comment.
ok,
(as a note: if no module need to have a more explicit description, we can make it generated by the macro and remove the ability to customize)
There was a problem hiding this comment.
That is probably better, because the notion of "events" could change, and we don't want to update the same comment in the entire SRML. There is documentation (at least in progress) on the Event type. Perhaps it makes sense to have a more thorough comment in srml/example/src/lib.rs and node-template/runtime/src/template.rs. Everything else should be consistent unless there is a unique feature to a module.
There was a problem hiding this comment.
macro generation now as such:
/// Events for this module.
///
/// (other doc of user if some)
Co-Authored-By: thiolliere <gui.thiolliere@gmail.com>
* improve decl_storage instance doc * use decl_event doc accordignly * automate doc and while allow to extend it on event * some missed ones * Update srml/example/src/lib.rs Co-Authored-By: thiolliere <gui.thiolliere@gmail.com> * Update srml/support/procedural/src/storage/transformation.rs
* WIP - SRML Assets Module README * docs: Tweaks for consistency * docs: Add missing newline * review-fix: Remove non-SRML trait dependencies * review-fix: Replace const with let * review-fix: Remove use of compact in signature * review-fix: Change const to let since cannot use result of function call * fix: Add backticks around type and mention type it derives from * review-fix: Update variable names since changed to lowercase since using let * fix: Change type to bold instead of code * review-fix: Update Asset module * refactor: Consistent bullet points. Remove whitespace between items * review-fix: Remove useless blah * review-fix: Remove Storage Items * review-fix: Remove Types * review-fix: Remove duplicate instructions * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * review-fix: Remove since will be replaced after macro expansion #2068 as per comment * review-fix: Move Goals within overview * fix: Fix indentation * style and a few minor changes * remove Events * capitalization * docs: Reword the Goals to remove mention of cold wallets based on discussion with Joe * Wording * Update lib.rs * Update lib.rs * Update lib.rs
* WIP - SRML Assets Module README * docs: Tweaks for consistency * docs: Add missing newline * review-fix: Remove non-SRML trait dependencies * review-fix: Replace const with let * review-fix: Remove use of compact in signature * review-fix: Change const to let since cannot use result of function call * fix: Add backticks around type and mention type it derives from * review-fix: Update variable names since changed to lowercase since using let * fix: Change type to bold instead of code * review-fix: Update Asset module * refactor: Consistent bullet points. Remove whitespace between items * review-fix: Remove useless blah * review-fix: Remove Storage Items * review-fix: Remove Types * review-fix: Remove duplicate instructions * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * Update srml/assets/src/lib.rs Co-Authored-By: ltfschoen <ltfschoen@users.noreply.github.com> * review-fix: Remove since will be replaced after macro expansion paritytech#2068 as per comment * review-fix: Move Goals within overview * fix: Fix indentation * style and a few minor changes * remove Events * capitalization * docs: Reword the Goals to remove mention of cold wallets based on discussion with Joe * Wording * Update lib.rs * Update lib.rs * Update lib.rs