feat(HowToGuides): how to create a custom boolean action

[guillesanbri]

A how to guide of creating a custom Zinnia.Action.BooleanAction

[thestonefox]

The style and flow of the guide is fine, it seems to flow well with the other guides. However, the thing that is a sticking point for me is the purpose of the guide.

Like is there a reason anyone would create a custom action that toggles based on a boolean checkbox in the scene inspector?

I totally get the reason for the guide of how to write a custom action, I'm just wondering if there is a better, more real world example of showing this?

Thoughts?

[guillesanbri]

Sure, I thought of that while writing and see eye to eye with you, but I couldn't think of a better example that wouldn't be too lenghty for an easy to read tutorial and that wouldn't steal the simplicity of writing the boolean action per se.

I thought about toggling the action depending on the position of a gameobject, if you prefer something like that I can give it a go.

[thestonefox]

Let's have a think about a good use case for a custom action. We can discuss it in the academy slack channel.

Besides the actual use case, the writing style is spot on.

As you're the only other person who has written a guide too, it would be good to get feedback of what are the pain points when writing the docs. Is there anything I can be providing (other than knowledge of the system obvs :p) that would help things?

Would providing the graphic arrows/outlines in like an svg format or something be useful?

[guillesanbri]

Going to Slack now, arrows and boxes pushed my photoshop skills to the limit, I wrote a little guide for myself to do the picture process, I will share it with you.

I think it would be useful to have something like a glossary of terms to copy-paste in the "Useful definitions" block.

[mhusinsky]

As you're the only other person who has written a guide too, it would be good to get feedback of what are the pain points when writing the docs. Is there anything I can be providing (other than knowledge of the system obvs :p) that would help things? Would providing the graphic arrows/outlines in like an svg format or something be useful?

Going to Slack now, arrows and boxes pushed my photoshop skills to the limit, I wrote a little guide for myself to do the picture process, I will share it with you.

i'd be glad if your used workflows could be public in some way as i'm considering helping with the docs at some point (actually i did already once, see #52).

personally i found using powerpoint to be the quickest and most compatible way to edit screenshots. just:

• screenshot (with marquee)
• paste to PP
• add arrows (from available shapes) and/or other things
• screenshot (with marquee) again (of course with slide size at 100%) and save final image

that is super quick and nice to edit (also, you can keep all graphics of a tutorial in one file). the only thing PP does not offer is a shadow under the arrow.

for animated gifs i find Screen2Gif very useful.

[thestonefox]

@mhusinsky are you in the slack #academy channel? if not, send me a DM on slack and I'll add you (it's a private channel)

[guillesanbri]

Closing this one, see #101