.. image:: images/kblockly-logo.png
   :width: 70%
   :align: center
   :alt: KookaBlockly Logo

""""""""""""""""""""""""""""""""""""""""""""
Welcome to the KookaBlockly Reference Guide!
""""""""""""""""""""""""""""""""""""""""""""

**KookaBlockly** is a powerful standalone visual editor designed for creating program scripts for **Kookaberry** and related microprocessors. 
This editor operates on a drag-and-drop interface, making it beginner-friendly and highly intuitive.

This document describes how to use to the **KookaBlockly** visual scripting tool.

**KookaBlockly** is part of the **KookaSuite** script editing toolset which was commissioned by the AustSTEM Foundation 
and created by Damien George for the **Kookaberry**.

This guide is for **KookaBlockly** v1.10.0.

The document is in TWO parts:

1. Working with **KookaBlockly** - relates to **KookaBlockly** set-up, basic screen displays and usage.
2. A Reference Document for the visual functional blocks in **KookaBlockly**.


.. toctree::
   :caption: Contents

   part1.rst
   part2.rst
   glossary.rst



:Example Scripts:

   All the scripts used in this guide are available for downloading from Github and following the instructions on the `README`_ page:

.. _README: https://github.com/TDStrasser/KookaBlockly-Reference/tree/9823056ad87da55329b65082e39b0654e418a5e6/examples


:Errata:

   If errors or issues are found in the **KookaBlockly Reference Guide** please `post an issue on GitHub`_.

.. _post an issue on GitHub: https://github.com/TDStrasser/KookaBlockly-Reference/issues


:Copyright:

   Blockly is a library from **Google** for building beginner-friendly block-based programming languages.

   **Kookaberry** and **Kooka** are trademarks of Kookaberry Pty Ltd, Australia.

   The **Kooka Firmware** release v1.10.0 and **KookaSuite** were created by Damien George (George Electronics Pty Ltd – **MicroPython**) 
   in collaboration with Kookaberry Pty Ltd and the AustSTEM Foundation Ltd.