Location
https://developers.google.com/blockly/guides/create-custom-blocks/extensions
Type
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.
Location
https://developers.google.com/blockly/guides/create-custom-blocks/extensions
Type
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.