News for hackers. Stuff that matters.
Re:GitHub Actions is my new favorite free programming tool [... by jpxw on Thursday December 19, 2019 @02:41PM (#21838445)
I assume you’re talking about Go here?
Re:GitHub Actions is my new favorite free programming tool [... by phodge on Thursday December 19, 2019 @04:30PM (#21839543)
Possibly Typescript. Try finding documentation for the bundled "Record" type. It seems you're supposed to just know how to use it already.
Re:GitHub Actions is my new favorite free programming tool [... by crooked-v on Thursday December 19, 2019 @04:45PM (#21839652)
Re:GitHub Actions is my new favorite free programming tool [... by STRiDEX on Thursday December 19, 2019 @06:42PM (#21840436)
I've heard the same typescript feedback from coworkers. Another commenter already linked to the official docs, I always link them to https://github.com/sindresorhus/type-fest#readme which has links and docs of the built in types and can be installed for more.
Re:GitHub Actions is my new favorite free programming tool [... by sli on Friday December 20, 2019 @01:06PM (#21846081)
I have yet to find a straight answer on how `declare` actually works in the Typescript docs. I had to go to Stack Overflow to learn what it's for.

The TS docs basically just say "use declare to declare [thing]" over and over, and it's only mentioned in the handbook on a page that doesn't seem to be listed in the handbook menu anywhere.[0] You have to search for it and wing it, because the search result for this just says "By Example." Notice that there is no article highlighted in the handbook menu on the left like there would be on any of the pages listed there.

[0]: https://www.typescriptlang.org/docs/handbook/declaration-fil...

Re:GitHub Actions is my new favorite free programming tool [... by toyg on Thursday December 19, 2019 @03:04PM (#21838668)
I wouldn't think so, docs in Go look very terse to me, not at all "story mode".

Maybe Rust or Clojure...?

Re:GitHub Actions is my new favorite free programming tool [... by shepmaster on Thursday December 19, 2019 @03:12PM (#21838753)
Rust has books [1] as well as the usual terse API docs [2], so that also seems unlikely.

[1]: https://doc.rust-lang.org/stable/book/

[2]: https://doc.rust-lang.org/std/

Re:GitHub Actions is my new favorite free programming tool [... by weberc2 on Thursday December 19, 2019 @03:07PM (#21838704)
Unless something has changed very recently, Go docs aren't story-format.