codewars / docs

The Codewars Docs :construction: WIP
https://docs.codewars.com
MIT License
56 stars 201 forks source link

Before start #413

Closed hobovsky closed 1 year ago

hobovsky commented 2 years ago

Page which attempts to explain some intricacies of Codewars to absolute beginners and users not really familiar with coding.

Preview: here Preview of "training example": here

kazk commented 2 years ago

I like the idea behind this page, but I think we need to present it better.

We should simply explain the differences from traditional coding challenge service that uses stdin/stdout by mentioning kata are unit tests, and how that affects you to write your solution.

hobovsky commented 2 years ago

We should simply explain the differences from traditional coding challenge service that uses stdin/stdout [...]

I don't like the idea of comparing Codewars to "traditional coding challenge service that uses stdin/stdout" because I think that users, especially the ones affected by the problem I am trying to address with this page, are not necessarily familiar with "traditional coding challenge service that uses stdin/stdout". It is possible that some users are confused because they try to apply analogies from other OJs, but I think that for majority of newbies, printing and reading is the first thing they learned somewhere (with some introductory materials, on some bootcamps, courses, internet, whatever), and it's the only known way of interaction their code can use.

[...] by mentioning kata are unit tests, and how that affects you to write your solution.

This is what I want to do, but initially I placed the page in another section of docs where mentioning tests did not really seem fit. Later I moved the page and here it's good place to mention tests, but I did not add it yet. I will think of something.

hobovsky commented 1 year ago

Since I got feedback from users that the page is generally useful, and questions from beginners pop up more and more often, I decided to merge it.
I will fix problems as they appear.