<confused>
slfritchie: thanks, thats in chapter 2 and reference capabilities are introduced in chapter 4, if the person who maintains the tutorial is here it might be better to introduce reference capabilities before using ref in a method definition (just a suggestion)
khan has quit [Client Quit]
khan has joined #ponylang
<SeanTAllen>
confused: there's a problem with doing that. i tried going through and never using anything before its introduced and like happens with many things, you end up in a circle where you could never start.
<confused>
SeanTAllen: maybe add 2 links then? from the use in chapter 2 link to the capabilities section in chapter 4 and from chapter 4 link to the example in chapter 2 (or paste it again there?)
<confused>
I feel at least there should be a reference to how capabilities are used for methods in the capabilities section
<SeanTAllen>
confused: it is much harder than it sounds. lots of folks have "what if... ideas", ive tried them and i dont think any help. feel free to take a stab, i would ask that you take a holistic approach and rather than "drop a link here", you try to have it make sense within the entire flow.
<SeanTAllen>
i dont think sending people around in circles in a tutorial is a good idea
<SeanTAllen>
its along the lines of...
<SeanTAllen>
when teaching Java, should you first teach what a class is...
<SeanTAllen>
does that mean you should teach how OO works, or just say "its a class"?
<confused>
I understand
<SeanTAllen>
we'll explain that later
<SeanTAllen>
i think its best to say
<SeanTAllen>
"its a class, dont worry if you dont know what that means right now"
<SeanTAllen>
if you find things like this where the tutorial isnt cutting it
<SeanTAllen>
my suggestion would be to try and fashion a new section that bring together information from a two sections into a new section
<SeanTAllen>
that covers the information from each section over again, in a fresh way that brings them together
<SeanTAllen>
to each the new, more complex topic of how they interact
<confused>
in any case the capabilities section shows how to use capabilities and there is no mention at all that you can put a capability in a method definition, an example there (maybe the same one from chapter 2) seems reasonable
<confused>
but its just a suggestion, it wont bite me again now that i know :)
<SeanTAllen>
i think that would be worthy endeavor. even if you dont feel up to writing the content. if you were to open an issue that described topics that needed to be revisited together, that could be helpful.
<SeanTAllen>
confused: ive discussed how if i was to write a pony book, i would start with reference capabilities. what they are, why they exist, the basis for thinking about them. many folks think that would be a bad idea. i think it would be a brilliant idea. but... folks have different ways of learning.
<confused>
fair enough
<SeanTAllen>
confused: please do open up issues for things like "i had to figure out what X was because of ..." with an explanation. That rather than a "solution" would be very helpful.
<SeanTAllen>
you open issues like that as someone who is just learning would be INCREDIBLY helpful
<SeanTAllen>
it will help identify gaps.
<SeanTAllen>
note, i will probably end up asking you lots of questions if you open such issues to try to better understand and come up with a good solution.
<confused>
ok, will do
khan has quit [Quit: khan]
_andre has quit [Quit: leaving]
acarrico has quit [Ping timeout: 260 seconds]
jemc has quit [Read error: Connection reset by peer]
jemc has joined #ponylang
mahmudov has quit [Remote host closed the connection]
user10033 has joined #ponylang
alxs has quit [Quit: Computer's gone to sleep. ZZZzzz…]
user10032 has quit [Ping timeout: 260 seconds]
alxs has joined #ponylang
alxs has quit [Quit: Computer's gone to sleep. ZZZzzz…]
Jwashton has quit []
emgonam2 has quit [Ping timeout: 248 seconds]
emgonam2 has joined #ponylang
user10033 has quit [Quit: Leaving]
codec2 has quit [Read error: Connection reset by peer]