added note regarding the status of the tutorial and ebook

This commit is contained in:
sejo 2024-03-28 20:47:53 +01:00
parent df3573f7a5
commit f8772f31c0
5 changed files with 24 additions and 4 deletions

View File

@ -7,6 +7,10 @@ introduction to uxn programming is a beginner's, slow-paced and comprehensive gu
originally available online as the {uxn tutorial}, this is a carefully revised version for you to have it offline and available anytime.
IMPORTANT (12024-03-28)! keep in mind that the contents of the ebook are written from a somewhat outdated perspective and some of them might be wrong. the online {uxn tutorial} is more up-to-date. some things are done differently now, and the tutorial doesn't cover all the possibilities in the language that exist nowadays. in doubt, always refer to the official documentation. however, we hope it's still useful to you as an introduction to the uxn ecosystem!
=> https://wiki.xxiivv.com/site/uxn.html XXIIVV — uxn official documentation
# download
=> https://compudanzas.itch.io/introduction-to-uxn-programming get introduction to uxn programming

View File

@ -7,12 +7,17 @@ we have a twitch channel that we're using to stream our maintenance practice, fo
# upcoming stream(s)
* 12024-03-28, thursday, 19:00-21:00 UTC+1
* no upcoming streams are scheduled for the moment. once we know about it we'll put it in the {log}
# stream log
in reverse chronological order:
## 12024-03-28: uxn tutorial
in this stream, we searched for the uses of macros in the whole tutorial and classified them according to how complex it would be to replace them with something more current. we replaced some macros (RTN) and listed the possible changes in the {roadmap}.
we also went through the list of the pending tasks and realized that everything should be working alright except for the pong example that needs to be modified in how it clears the sprites.
## 12024-03-16: uxn tutorial day 2 (part 2.1)
in this stream, we updated the example sprite for the 1bpp mode; it's now an arrow pointing downwards and to the left so that the flipping is more evident. we updated the corresponding code.

View File

@ -48,7 +48,6 @@ this is an overview of how macros are used and what would be needed to replace t
* in {uxn tutorial day 5} we re-work MOD
* in {uxn tutorial day 6} we use constants, and HALF, DOUBLE
### further possible changes
* make a folder of examples
* whenever we mention the theme loading, link to the suggested palette.

View File

@ -2,10 +2,16 @@
lang=en es->{tutorial de uxn}
a beginner's, slow-paced and comprehensive guide for programming the varvara computer based on the {uxn} core.
you can get an offline version of this guide as the {introduction to uxn programming book}!
if you prefer video, you can watch a short {intro to uxn programming} workshop that we taught as an introduction.
IMPORTANT (12024-03-28)! even though we updated to some extent the tutorial during our {maintenance practice}, and in principle everything that we say here works, keep in mind that it is written from a somewhat outdated perspective. some things are done differently now, and the tutorial doesn't cover all the possibilities in the language that exist nowadays. in doubt, always refer to the official documentation. however, we hope it's still useful to you as an introduction to the uxn ecosystem!
=> https://wiki.xxiivv.com/site/uxn.html XXIIVV — uxn official documentation
if you'd like to contribute improving the tutorial, check out our to-do list in the {roadmap} and {contact} us!
there is an offline version of this guide as the {introduction to uxn programming book}, but it still needs to incorporate some of the changes we did here.
# day 1
in this first section of the tutorial we talk about the basics of the uxn computer called varvara, its programming paradigm in a language called uxntal, its architecture, and why you would want to learn to program it.

View File

@ -4,6 +4,12 @@ hello! in this first section of the {uxn tutorial} we talk about the basics of t
we also jump right in into our first simple programs to demonstrate fundamental concepts that we will develop further in the following days.
IMPORTANT (12024-03-28)! even though we updated to some extent the tutorial during our {maintenance practice}, and in principle everything that we say here works, keep in mind that it is written from a somewhat outdated perspective. some things are done differently now, and the tutorial doesn't cover all the possibilities in the language that exist nowadays. in doubt, always refer to the official documentation. however, we hope it's still useful to you as an introduction to the uxn ecosystem!
=> https://wiki.xxiivv.com/site/uxn.html XXIIVV — uxn official documentation
if you'd like to contribute improving the tutorial, check out our to-do list in the {roadmap} and {contact} us!
# why uxn?
or first of all... what is uxn?