classic ruby problem:
-
classic ruby problem:
“here’s this great library! everyone’s using it!”
“nice, where’s the api documentation?”
“here’s an example of how to use it!!”
“but like. the documentation. how do i know what methods i can use.”
“… these examples should help!!!”
-
Type VII Truthy Transsexualreplied to Unit vy-let last edited by
@vy i hit this especially hard with the gem that Mastodon uses for Elasticsearch. the source: unreadable. the docs:
"just use the DSL!"
"what are the DSL keywords etc.? what happens when i need to build something more dynamic or deal with lower-level concerns?"
"here are some more DSL examples! isn't this cool?"
-
doll!replied to Type VII Truthy Transsexual last edited by
-
@hierarchon @vyr @vy I used some Python libraries where approximately the only documentation was doctests once. It was…weird. Not the worst, but not recommended.
Copyright © 2024 NodeBB | Contributors