search

ev3dev / ev3dev.github.io

pretty web page for ev3dev
http://www.ev3dev.org
44 stars 184 forks source link

Add a separate page which explains ev3dev #249

Open WasabiFan opened 7 years ago

WasabiFan commented 7 years ago

From ev3dev/ev3dev#734.

WasabiFan commented 7 years ago

From ev3dev/ev3dev#783:

@wasabifan:

what if we created a documentation page on "ev3dev fundamentals"? Such a page would explain the relationship between images, kernels and "ev3dev versions"; essentials of packages; basic concepts of using sensors/motors; and the capabilities that the EV3 provides, among other things. I think that would be useful as a step in the "getting started" guide, and would likely help any ev3dev user, beginner or advanced.

@JorgePe:

I like the idea of an "ev3dev fundamentals" page as also a "what is ev3dev". I know that there are already many pages trying to achieve that same purpose but there isn't a sort of "ev3dev for beginners" guide offering a good, complete, from-start-to-the-end tutorial.

I think we're targeting two independent pages: one which explains what ev3dev is to someone who is considering using it, and one which explains the technical fundamentals in moderately more detail. Both would still target beginners.

JorgePe commented 7 years ago

I agree. I'm not a fluent English writer but If you think I can help please count with me.

WasabiFan commented 7 years ago

@JorgePe Help is always appreciated! If you don't feel you could write a whole page, you could create a bulleted outline (and post it here) which lays out the information that should be included.