google/blockly

Include Tutorial about MutatorIcon

Opened this issue · 3 comments

Location

https://developers.google.com/blockly/guides/create-custom-blocks/extensions

Type

  • Text
  • Image or Gif
  • Other

Suggested content

The guide Extensions has never mentioned MutatorIcon. Thus, when users want to write a block like 'text_join' or 'list_create_with', they might find their block missing the left-most gear icon through which the mutator UI can be opened. The issue could be commonplace.
According to the guide, the decompose and compose functions provide the container block at the top of the mutator workspace. But the guide fails to tell readers that MutatorIcon provides information about the FlyOut of that workspace. The knowledge system is incomplete and we confuse how 'text_join_item' and 'list_create_with_item' are specified as choices in the FlyOut.
Hopefully a paragraph about MutatorIcon can be added to the guide Extensions.

Additional context

I sincerely appologize for my disturbance. Please forgive me if I am making mistakes as this is the first time for me to open an issue at blockly. I could not find a contribute button at the guide page, and I have no permission to post conversations at Google Groups. (I tried to post conversations, but after clicking Post Message, nothing happened and I could not find my conversation anywhere.) Sorry again if I am submitting an issue at the wrong place.

Heya @William-Shi233 thanks for the info =) This is actually the right place to submit this issue! It looks like your posts on the forum got caught in the spam filter. Next time you post there, it might take a bit for the messages to show up, but we will approve them!

Thanks again! --Beka

@BeksOmega i would like to work on this issue, can u please assign me this issue

@Spoorthy1423 sadly the doc site is actually not open source :/