Jump to content




Ask A Pro Renewal Project (and How You Can Help!)


115 replies to this topic

#41 Sora Firestorm

  • Members
  • 89 posts

Posted 26 August 2013 - 01:08 PM

Wrote the 'Modem intermediate - remote peripherals' tutorial : http://www.computerc...te-peripherals/

(And on an off-topic note : what is possessing people to do recursive function calls to loop? I didn't even think of it when I was learning how to program...)

#42 GopherAtl

  • Members
  • 888 posts

Posted 26 August 2013 - 01:49 PM

Honestly, it's a result of people NOT learning recursion or loops properly. I think it started with some youtubers who were using recursion improperly and from them it's spread virally, noob to noob.

#43 Lyqyd

    Lua Liquidator

  • Moderators
  • 8,465 posts

Posted 26 August 2013 - 02:00 PM

View PostSora the Hedgehog, on 26 August 2013 - 01:08 PM, said:

Wrote the 'Modem intermediate - remote peripherals' tutorial : http://www.computerc...te-peripherals/

(And on an off-topic note : what is possessing people to do recursive function calls to loop? I didn't even think of it when I was learning how to program...)

Thanks! I've left some critique on the topic for possible improvements that would steer it toward the quality we are looking for. :)

#44 immibis

    Lua God

  • Members
  • 1,033 posts
  • LocationWellington, New Zealand

Posted 29 August 2013 - 04:52 AM

View PostSora the Hedgehog, on 26 August 2013 - 01:08 PM, said:

(And on an off-topic note : what is possessing people to do recursive function calls to loop? I didn't even think of it when I was learning how to program...)
Perhaps the lack of goto?

("How do you make it go to a specific line?" "Well, you can use functions, but that-" "I'll take 20!")

#45 LBPHacker

  • Members
  • 766 posts
  • LocationBudapest, Hungary

Posted 29 August 2013 - 05:59 AM

Shoving another wanna-be tutorial onto the top of the pile: The Term Api - Controlling The Terminal

#46 GopherAtl

  • Members
  • 888 posts

Posted 29 August 2013 - 08:36 AM

View Postimmibis, on 29 August 2013 - 04:52 AM, said:

View PostSora the Hedgehog, on 26 August 2013 - 01:08 PM, said:

(And on an off-topic note : what is possessing people to do recursive function calls to loop? I didn't even think of it when I was learning how to program...)
Perhaps the lack of goto?

ugh. Trust me, the presence of goto in lua would just make this worse, with people putting labels inside loops, trying to goto labels in other functions, skipping over variable declarations, skipping to before variable declarations and re-initializing them and clobbering their values...

#47 Sora Firestorm

  • Members
  • 89 posts

Posted 30 August 2013 - 02:05 PM

I know that people generally view goto as a bad thing, but what about jmp? I know that it's effectively a unconditional goto... whatever.
We should get back on topic. Sorry for the thread-jack, Lyqyd. ^.^ v

#48 Lyqyd

    Lua Liquidator

  • Moderators
  • 8,465 posts

Posted 01 September 2013 - 03:45 PM

Here is the first tutorial in the series, Computer Basics I: http://www.computerc...puter-basics-i/

Feedback would be appreciated!

#49 theoriginalbit

    Semi-Professional ComputerCrafter

  • Moderators
  • 7,332 posts
  • LocationAustralia

Posted 01 September 2013 - 03:55 PM

View PostLyqyd, on 01 September 2013 - 03:45 PM, said:

Here is the first tutorial in the series, Computer Basics I: http://www.computerc...puter-basics-i/
Feedback would be appreciated!
Very, very, good... Simplistic and uses lots of images which would very much help out the new user... Only 3 minor things I would suggest:

1. Maybe snip the crafting grid screenshot so it is bigger and there is less Minecraft window and more recipe.
2. Specify that the edit program, the program you want to edit is specified with the command line argument, just like with the list command. And state how lots of programs (cc and user made) quite often make use of runtime arguments.
3. Might fall out of scope of the tutorial, but I think its the best one to be in... Show and tell about the "programs" program, so they can see the CC programs?

Other than that, like I said, very good.

#50 Lyqyd

    Lua Liquidator

  • Moderators
  • 8,465 posts

Posted 01 September 2013 - 04:05 PM

Your first point is a good one; I'll adjust the image accordingly. As to the second point, I could probably clarify that better. I'll look at revising that piece of the text. The third point is indeed out of the scope of this tutorial, as it is covered (both help and programs) in the second tutorial in the Computer Basics group, which I'm sitting down to work on now.

Thanks!

#51 theoriginalbit

    Semi-Professional ComputerCrafter

  • Moderators
  • 7,332 posts
  • LocationAustralia

Posted 01 September 2013 - 05:40 PM

View PostLyqyd, on 01 September 2013 - 04:05 PM, said:

The third point is indeed out of the scope of this tutorial, as it is covered (both help and programs) in the second tutorial in the Computer Basics group, which I'm sitting down to work on now.

Thanks!
Oh I didn't even see programs in the list, haha. I think I was reading it wrong maybe.

No problems :)

#52 Lyqyd

    Lua Liquidator

  • Moderators
  • 8,465 posts

Posted 01 September 2013 - 05:49 PM

Computer Basics 2 is up. I'm about to go back and look at the edit section of Basics 1 as suggested. Feedback on both of these would be appreciated! These should sort of set the example for what we're looking for in a tutorial. One that takes time to walk through things step by step, and explain at least a little bit about what's going on, as well as give the user the opportunity to play around with things a little bit. Obviously, some of those points are going to be a little less practical in other tutorials, but that's the sort of general feel we're going for here.

Edit: And I've updated Basics I. Let me know if that covers your suggestion, or if you still think it's insufficient.

#53 theoriginalbit

    Semi-Professional ComputerCrafter

  • Moderators
  • 7,332 posts
  • LocationAustralia

Posted 01 September 2013 - 06:19 PM

View PostLyqyd, on 01 September 2013 - 05:49 PM, said:

Edit: And I've updated Basics I. Let me know if that covers your suggestion, or if you still think it's insufficient.
Much better for the `edit` program. Did you change the size of the first image? It doesn't look much different to me.

EDIT 1:

View PostLyqyd, on 01 September 2013 - 05:49 PM, said:

As most of these programs output quite a lot of data to the screen, could it be worth clearing the screen before running the program? Just to make the screenshots look a little less cluttered.

EDIT 2:
Also I know it's not ideal, but would it be worth having a pinned topic with links out to the AaP Renewal tutorials, so they don't get lost in the sea of tutorials?

EDIT 3:

Quote

When a computer has a label, you can pick up the block by breaking it, and it will retain its ID and all of the programs that you've created on it.
Worth mentioning that turtles also keep their fuel level? or is that something that should be referenced back in the turtle tutorial?

And lastly...
Is it worth saying that with the rename, move, cd, copy, etc, we can use specify an absolute path to be able to move to a completely different location? For example running say `tutorial> mv bar /tutorial2/bar/foo`.

Edited by theoriginalbit, 01 September 2013 - 06:46 PM.


#54 Lyqyd

    Lua Liquidator

  • Moderators
  • 8,465 posts

Posted 01 September 2013 - 06:49 PM

I didn't resize the first image, but I did crop out the extra stuff. If it doesn't appear different, try clearing your cache and refreshing the page. It's now just the crafting grid and results box.

Clearing the screen is a possibility, though the tutorials are meant to be walked through with a computer, so at this point, they display exactly what the player would see on his screen if he followed the tutorial exactly. If it is found to be too distracting, they could be re-shot with a cleared screen for each shot.

The pinned topic already exists, it just hasn't been made visible yet. Since these tutorials are starting to get written, I may make it visible soon.

Just noticed your signature the other day, by the way. I like the first line of it. ;)

#55 theoriginalbit

    Semi-Professional ComputerCrafter

  • Moderators
  • 7,332 posts
  • LocationAustralia

Posted 01 September 2013 - 06:53 PM

View PostLyqyd, on 01 September 2013 - 06:49 PM, said:

I didn't resize the first image, but I did crop out the extra stuff. If it doesn't appear different, try clearing your cache and refreshing the page. It's now just the crafting grid and results box.
Ahh I'll try clearing, 'cause it looks exactly the same to me atm.

View PostLyqyd, on 01 September 2013 - 06:49 PM, said:

The pinned topic already exists, it just hasn't been made visible yet. Since these tutorials are starting to get written, I may make it visible soon.
Haha ok. Great minds....... o.O :P

View PostLyqyd, on 01 September 2013 - 06:49 PM, said:

Just noticed your signature the other day, by the way. I like the first line of it. ;)
I liked it too, and hole-heartedly agreed so put it in... I tried to get a "— Lyqyd" in there, but apparently I've hit my maximum of 3 lines of text (and that's even after I've shortened the urls) so I couldn't do it.

#56 Lyqyd

    Lua Liquidator

  • Moderators
  • 8,465 posts

Posted 01 September 2013 - 06:55 PM

Made the topic visible--it's now Read This Before Asking Questions or something to that effect. A couple of stickies that it supercedes will be removed now.

Edit: I'll go through some of the other tutorials written for this in the next couple of days and ensure that they meet quality standards and then link them in. We do need the basic tutorials written before the intermediate ones get linked, though.

#57 theoriginalbit

    Semi-Professional ComputerCrafter

  • Moderators
  • 7,332 posts
  • LocationAustralia

Posted 02 September 2013 - 03:29 PM

View PostLyqyd, on 01 September 2013 - 06:55 PM, said:

Edit: I'll go through some of the other tutorials written for this in the next couple of days and ensure that they meet quality standards and then link them in. We do need the basic tutorials written before the intermediate ones get linked, though.
I'm assuming that we'll be avoiding duplicates, so perhaps in OP strikethrough the ones that are already done?

EDIT: Also should `peripheral.getNames` be covered in the Peripheral Basics tutorial, or not since it's really more of the remote peripherals tutorial job?

Edited by theoriginalbit, 02 September 2013 - 03:47 PM.


#58 Lyqyd

    Lua Liquidator

  • Moderators
  • 8,465 posts

Posted 02 September 2013 - 03:47 PM

That's likely to happen, though I want everyone to bear in mind that we are going for a wiki-like approach. The initial document has to be written at some point, but then anyone with sufficient knowledge of Lua and ComputerCraft can suggest improvements and provide rewritten passages for approval and acceptance. At some point, the tutorial series will be migrated off of the forums and on to either the Wiki or another cc.info-controlled content management platform so that all approved tutorial editors can work on improving them. Depending on how long that takes, we may have some temporary forum-based system to allow similar things. On either system, we'd likely have an arrangement wherein suggested edits are posted and given a chance to be commented on before being edited into the tutorial itself. Essentially, I'm looking to get a community-created set of tutorials rather than many tutorials whose content is controlled by their original author.

#59 theoriginalbit

    Semi-Professional ComputerCrafter

  • Moderators
  • 7,332 posts
  • LocationAustralia

Posted 02 September 2013 - 03:55 PM

View PostLyqyd, on 02 September 2013 - 03:47 PM, said:

-snip-
Sounds good :)

Oh also, vanilla CC peripheral crafting (other than disk drives), which tutorial does that make it into? Computer Basics 3?

Edited by theoriginalbit, 02 September 2013 - 03:58 PM.


#60 Lyqyd

    Lua Liquidator

  • Moderators
  • 8,465 posts

Posted 02 September 2013 - 04:03 PM

We may do a recipes spoiler in Basics 1, but the other peripherals can have recipes shown where they are introduced. Peripheral intermediate deals with printers, modem series for modems, monitor basics for monitors, etc. I think between the various other tutorial series, we introduce every peripheral in ComputerCraft. I think just about the only thing we don't have a reason to introduce is the advanced turtle, so perhaps that one will end up only being shown in the recipe list in Computer Basics 1.

Good question!





1 user(s) are reading this topic

0 members, 1 guests, 0 anonymous users