AltME: Red Docs

Messages

DocKimbel
Actually, I would like to have the docs (at least (1)) for the first "public alpha", so around end of March (as soon as we have good enough GUI and I/O). We'll start doing promotion/buzzing, so we need it before 1.0.
DocKimbel
Peter, Language Reference will be very technical, not practical. It won't explain you how to use Red, but describe Red's syntax (using BNF), semantic rules, notes about implementation and exhaustive list of core functions.
DocKimbel
Peter, I am hoping to attract many beginners/inexperienced users for 1.0 (or even before), and not only experienced ones. But it's difficult to predict in which category of users Red will generate the most traction.
PeterWood
So the User Guide should be the priority.
DocKimbel
I think so.
amacleod
Doc, I hope to focus on the beginners and young users myself. I taught high school science for six years and I never lost my interest in promoting programming as a tool for my students that were not necessarily interested in computers...Now wiith Red I hope to show the FUN in using computers to create things (apps/projects). My children are ages 8 and 9 and I will be using them as a test case for a book/website/curriculum that I am going to pursue.
DocKimbel
Alan, glad to hear that. I would love Red to be used for education. We would probably need to build some additional layers in provide simpler interfaces for young beginners. I think you should talk with PeterWood more. ;-)
Gregg
For all of us who want to use Red to teach, we should look at old Logo resources. There are a lot of beginner and turtle graphics examples out there, but there's also NetLogo and Brian Harvey's amazing series "Computer Science Logo Style", though that's more advanced. I even did a tiny turtle graphics interpreter in REBOL a long time ago.
Some tools and dialects are all we need. ;-)

Reichart
What has been the best resources out there for REBOL in terms of education?
Learning what to do, and not do probably has value, but copying work that has already been done could save a lot of time and energy.
Andreas
> What has been the best resources out there for REBOL in terms of education?
The old mailing list ...
Gregg
Andreas +1. On docs, Carl said he didn't want the REBOL user guide copied. Nick's work, and some others', are also great resources. I hope we can leverage those in the future. The main thing there will be differences in Red that have to be accounted for. A LOT of REBOL docs will apply to Red directly as well, which is great.
And, yes, if you're thinking it would be good to document the differences as well as compatibilities between REBOL-like languages, I started some things on that a long time ago. A lot of our work now can be looking in dark corners and dusting things off. Bulk prose (the content) is the big stuff now.
Reichart
Well, "copied" is a strong word :)
I have always like the word "Homage"
Gregg
:-) I'm all for attribution on anything we can pay homage to.
Geomol
I find myself using these docs mostly:
REBOL/Core Users Guide
http://www.rebol.com/docs/core23/rebolcore.html
REBOL Function Dictionary
http://www.rebol.com/docs/dictionary.html
REBOL/View VID Developer's Guide
http://www.rebol.com/docs/view-guide.html
DRAW Dialect Reference
The old version of draw-ref.html , which I can't find online, but I have it locally.
But all these are mostly docs or references, maybe not educational for beginners to the language. I can't think of a good beginner guide for these kinds of languages, but I haven't read all, so maybe it exists.

Reichart
I'm a fan of putting a crap load of stuff on a single page, esp. "Most common used words" with lots of examples.
In general though, I go to Google, type things like "rebol parse example" and get good enough.

Arnold
I want to make a Red/System doc for assisting programming Red. The idea is to quickly look up the definitions of all the used types. Such a document will be useful for Red/System 1.0 but will be easily extended for Red/System 2.0 later.
Gregg
Not sure what you mean by "used types", but any docs are helpful.

Arnold
cell!, red-value!, red-block! red-string! etc. On the one side I would like a paper version, so an index and all. On the other side a little referential program to help you look up items fast and not searching through the sources yourself, but maybe it should use the sources.

Last message posted 405 weeks ago.