I don't really have any feedback on what you have, but for what
you don't have:
1. docs/compiler_faq.pod teaches exceptions nicely enough; I think
a tutorial of it could mainly use a 'why labels and not subs?'
and maybe a small example of what happens when you accidently
enter the exception-handler.
2. docs/art/pp003-oop.pod teaches OOP in PIR
3. docs/glossary.pod and docs/compiler_faq.pod talk about
coroutines (and compiler_faq claims to talk about closures,
but does not).
4. docs/compiler_faq.pod talks about optional arguments and tail
calls and slurpy arguments and such; you might show a
tail-recursive function as an alternative to gotos (and talk
about any performance concerns?)
5. pdds/pdd20_lexical_vars.pod describes those well.
6. art/pp002-pmc.pod is really cool, with lots of small programs
that dissect the environment, and I pretty much learned PIR
from it the other day, myself.
Following 6, I think a tutorial would benefit from compilable
chunks of code more than from skeleton-PIR. I think it'd be
generally nice if the tutorial could have pervasive links into
deeper documentation, so that you can on one pass use it for
a basic tutorial and then on a second pass use it as a platform
for deeper understanding.
You should definitely point out that Parrot has wizzy
internationalized strings, if you plan to go into PMC types :-)
I am very glad to see this. One suggestion and one request for
1. First bullet point in FAQ should be: What does PIR stand for?
Although you answer it two paragraphs below in the Introduction, this
deserves to be right at the top. Until today, I did not know what PIR
stood for -- and that was despite working on the project for four
months. So others are likely not to know the abbreviation's meaning,
either. (And while you're at it, you should state what 'PASM' stands
for as well.)
2. Under your "your first Parrot program" you say type this "assuming
you successfully compiled Parrot." My guess is that that means you
successfully completed 'make install' -- correct? If so, it would
probably be clearer to say "have successfully installed Parrot."
HTH. Thank you very much.
> HTH. Thank you very much.
thanks for the feedback,