One of the things I’ve wanted to do since becoming an #OpenFL contributor (but hadn’t found the time) is add more documentation. Especially targeting new users unfamiliar with #AdobeFlash and maybe even newish to programming and not sure how to translate old #AS3 code to #Haxe.
This week, I tagged along on my wife’s work trip to Japan, and I decided docs would be a good thing to work on during my breaks from going out into Tokyo and doing touristy stuff. 🧵 1/x
Did you know that the official #AdobeFlash docs were Creative Commons licensed? Very convenient for the #OpenFL project.
An earlier contributor started adapting the “ActionScript 3.0 Developer’s Guide” a while back. Several chapters about events and the display list were already converted using Gitbook. However, efforts stalled, and things like mouse/keyboard/touch, text rendering, and sound playback were never introduced. Those are essential core things that folks will want to learn about! 2/x
Last summer, I manually scraped the entire #AS3 dev guide for #AdobeFlash, and I converted it to Markdown with some basic scripts and a little manual tweaking. I posted the result on GitHub: https://github.com/joshtynjala/actionscript-3.0-developers-guide
I’ve been trying to archive old Flash learning content lately. Maybe there will be a wave of nostalgia for that era of web games someday. Maybe some of it can be useful in unexpected ways to projects like #Ruffle and #OpenFL. It’s a part of web history and doesn’t deserve to be lost.
A Markdown version of the ActionScript 3.0 Developer's Guide by Adobe, licensed Creative Commons BY-NC-SA - GitHub - joshtynjala/actionscript-3.0-developers-guide: A Markdown version of the Act...
Some of the new #OpenFL docs that I converted from #AdobeFlash this week thanks to Creative Commons:
Working with sound: https://books.openfl.org/openfl-developers-guide/working-with-sound/
Using the TextField class: https://books.openfl.org/openfl-developers-guide/using-the-textfield-class/
Working with byte arrays: https://books.openfl.org/openfl-developers-guide/working-with-byte-arrays/
4/x
More new #OpenFL docs.
HTTP communications: https://books.openfl.org/openfl-developers-guide/http-communications/
Mouse, keyboard, and touch input events:
https://books.openfl.org/openfl-developers-guide/mouse-input/
https://books.openfl.org/openfl-developers-guide/keyboard-input/
https://books.openfl.org/openfl-developers-guide/touch-multitouch-and-gesture-input/
All code examples converted to #Haxe (and verified to compile and run… found some bug fixes in the process).
I will also add links to these documents into the OpenFL API Reference, to make them easier to find. And to present multiple formats of documentation in context, for folks who learn in different ways. 5/x
Finally, a few things I’ve enjoyed while in Tokyo. Mostly food related.
Finding random American restaurants like Lil Woody’s burgers from Seattle, and Shakey’s Pizza.
Tapping my phone to ride subways. Actually, top notch subway service in general.
Best bowl of ramen I’ve ever had.
Still quality food from really inexpensive restaurants (and even decent premade stuff from 7/11 convenience stores).
Headed to Kyoto tomorrow on a bullet train. Excited for more excellent mass transit. End thread 6/6
Josh Tynjala