search

ConsenSys-Academy / basic-training

Open-source repo for ConsenSys Academy's Basic Training: a software fundamentals course covering Unix-like OSes, CLI, Git, Javascript and more
https://courses.consensys.net/courses/bootcamp-basic-training
89 stars 99 forks source link

Add "check date for tutorial" somewhere in the course #17

Open ConsenSys-Academy opened 3 years ago

ConsenSys-Academy commented 3 years ago

This is a bit random and low hanging fruit, but maybe in the "How to Ask a Question" section, we can add that folks should check when tutorials were written. Particularly for blockchain, specifically Ethereum, these tutorials go stale rather quickly, so you want to check the date and the main libraries used to make sure you don't get weird errors different from the tutorial.

Please don't just copy the above message into the HTML somewhere. If someone could explain it a bit and find a reasonable place to put it, that'd be great!

We're open to a new section about troubleshooting, maybe?

ahcodes commented 3 years ago

@ConsenSys-Academy Hi, I'd like to help with this issue, but I'd need some guidance along the way since I'm a newbie.

ConsenSys-Academy commented 3 years ago

@ahcodes Hey there! Thanks for pinging our discussion. Essentially, we want to add a "Odds and Ends" section to the first module in our course.

Here's what I'd recommend to get started, since you're new to this:

1) Get familiar with the material: This is actually a live course you can take for free, which will walk you through the content and you can get a feel for the overall structure. Here's the course page..

2) Get familiar with the code: The code in this repo builds a raw HTML page, which is then served up by our learning server, which builds it into a course. Each HTML page is copied from template.html, which you can see in the home directory. If you're not familiar with HTML, we recommend checking out something like this Introduction to HTML course by Mozilla.

Once you've done these things, you'll have a feel for the way both the material and the code is written and structured!

I know it seems like a lot, but you won't have to do this for every project you start, just the first few to get a feel of how different kinds of projects are structured!

Let us know if you have any questions.