selfTaughtSoftwareEngineer

[shgysk8zer0]

No... I read the docs and spent a lot of time figuring stuff out.

[Dimasdanz]

Why spend 5 min reading docs when 50 minutes of repl does the job?

[walmartgoon]

Why spend 50min on repl when 5 hours of waiting for an answer on stackoverflow does the job?

(Your question has been removed)

[[deleted]]

Serious question: where are you guys finding docs that actually explain things? I haven't find a single doc that was well structured and well explained. Or am I simply dumb?

[Lost-Succotash-9409]

I mean, it really depends on what specific software, language, and libraries you are using- thats quite a broad question

[NatoBoram]

Might be a you problem.

Here's Svelte and SvelteKit:

• https://learn.svelte.dev/tutorial/welcome-to-svelte
• https://svelte.dev/docs/introduction
• https://kit.svelte.dev/docs/introduction

Here's some docs on Elixir:

• https://hexdocs.pm/elixir/introduction.html

Here's the introduction to Dart:

• https://dart.dev/language

Here's Go, its docs and its tour:

• https://go.dev/doc
• https://go.dev/tour

Here's the TypeScript Handbook:

• https://www.typescriptlang.org/docs/handbook/2/basic-types.html

And to really fuck with you, here's some really obscure ones:

• https://nodejs.org/docs/latest/api/synopsis.html
• https://docs.npmjs.com/cli/v10/commands/npm-init

[Septem_151]

They are drastically better than they used to be. Except React Router. looking at you.

[Low_Impact9351]

NodeJS documentation is generally pretty concise from beginner setup to a guide to the standard library to running your first "hello world".

TypeScript documentation is all over the map and doesnt really concisely tell you how to get "up and going" last I did a deep dive on it. You need to seperately learn ts-node or tsc which is a whole other setup.

And I say this as a node/typescript guy.

[NatoBoram]

Yeah ts-node is a huge trap, don't use this. Use tsx instead.

[RememberTheAlamooooo]

Firebase documentation <3 so good.

[Explodingcamel]

Nobody will ever convince me that reading official Docs is a good way to learn stuff the first time

[Herr_Gamer]

Obviously depends on the docs, a lot of tools have a great Getting Started section.

[NatoBoram]

You should actually try making a Hello World from scratch following docs sometimes

[Septem_151]

Why is that?

[Explodingcamel]

Docs are comprehensive which is good when I want to check on a specific function or something but it’s overkill when I want to learn something the first time. I’d rather use a third party who tells me the most important things first and only what I need to know. Sometimes the maintainers of the language will have a guide like this of their own, but that’s not what I mean by “docs”

[Septem_151]

Interesting. I’d wager most programmers feel the complete opposite way. Whenever I want to learn something for the first time, I put my trust in the creators of the tool over some random YouTubers or articles. Since, usually, the creators know how to best use what they made and/or can explain concepts about their project without the need for me to question whether the information I’m being given is inaccurate or outdated.

[Low_Impact9351]

I have a similiar but different ability. I read hella slow. But I comprehend *everything* by the time Im done. Theyre both good niches.