search

nodejs / website-redesign

Facilitating the redesign of the nodejs.org website
Other
99 stars 53 forks source link

Getting started with node #9

Closed maddhruv closed 6 years ago

maddhruv commented 6 years ago

Adding new sections to the Getting Started -

I propose this idea for the new website.

jestho commented 6 years ago

I would really like to see a "try in your browser" REPL-thingy. Would fit into the Getting Started section, but also on the front/landing page.

(Although I see the irony in running server-side JavaScript in the browser 😅)

amiller-gh commented 6 years ago

I love the in-browser playground idea, most of the best docs sites out there let you try out their languages/frameworks in-browser! (Scala, Go, React, etc...)

Are there existing solutions we could use for an in-browser Node REPL?

amiller-gh commented 6 years ago

Glot.io is open source and provides an API: https://glot.io/snippets/exf503wqxt

amiller-gh commented 6 years ago

Typically, sites will provide a "Learning Paths" style tutorial or education page section on their site:

It would be great to offer content in this format for learning the basics of Node.js development. Is there an existing curriculum out there we can use as a foundation for the new Getting Started learning path?

ghost commented 6 years ago

You can find useful Getting Started guides here.

darcyclarke commented 6 years ago

Hey folks!

Apologize I'm late to the game here (wasn't able to make the meeting last week). I think the playground idea is perfect for helping guide new folks along. I've been playing with Runkit for awhile and was going to use it on Toronto's NodeSchool site to help people immediately try out some of the code we are teaching them. Again, this kind of in-browser runtime environment should probably be supplementary to more standard written documentation/guidelines as mentioned above.

I think one of the questions/concerns I'd have for running with glot, specifically, is that it looks like it's not actively maintained (I could be wrong though).

maddhruv commented 6 years ago

For the Getting Started - learn Nodejs, new to nodejs we can refer to the repo - https://github.com/nodejs/getting-started and can also invite content writers to make us easy to understand and more accurate contents for the Getting Started section

bnb commented 6 years ago

Going to remove the agenda label from this, since it seems there's been no further discussion or progress since the last meeting 👍

maddhruv commented 6 years ago

closing in context with #18