2024/07/08

Newest at the top

2024-07-08 05:27:55 +0200 <EvanR> as god intended
2024-07-08 05:27:35 +0200 <EvanR> documentation is overrated, I want it all trashed and a single snippet that shows the library doing 1 useful but highly specific task
2024-07-08 05:19:07 +0200xdminsy(~xdminsy@117.147.70.227)
2024-07-08 05:18:14 +0200xdminsy(~xdminsy@117.147.70.227) (Ping timeout: 268 seconds)
2024-07-08 05:16:51 +0200bitdex(~bitdex@gateway/tor-sasl/bitdex)
2024-07-08 05:13:07 +0200aforemny_(~aforemny@2001:9e8:6cc4:ed00:8551:e69c:b7dd:ec64) (Ping timeout: 260 seconds)
2024-07-08 05:11:51 +0200aforemny(~aforemny@2001:9e8:6ce5:1500:7cdb:cdf7:8d8:ba53)
2024-07-08 05:10:13 +0200euleritian(~euleritia@77.22.252.56)
2024-07-08 05:09:37 +0200euleritian(~euleritia@77.22.252.56) (Read error: Connection reset by peer)
2024-07-08 05:05:05 +0200euleritian(~euleritia@77.22.252.56)
2024-07-08 05:04:47 +0200euleritian(~euleritia@dynamic-176-003-015-111.176.3.pool.telefonica.de) (Read error: Connection reset by peer)
2024-07-08 04:54:31 +0200 <lain`> in general
2024-07-08 04:54:25 +0200 <lain`> it can be hard to find examples of even fairly simple/common things that aren't like 8 years old and don't compile anymore
2024-07-08 04:52:19 +0200 <lain`> it wasn't just one, but the lens and mtl documentation aren't ideal imo
2024-07-08 04:45:55 +0200terrorjack(~terrorjac@2a01:4f8:c17:87f8::)
2024-07-08 04:45:38 +0200dyniec(~dyniec@dybiec.info) (Quit: WeeChat 4.2.2)
2024-07-08 04:43:59 +0200terrorjack(~terrorjac@2a01:4f8:c17:87f8::) (Quit: The Lounge - https://thelounge.chat)
2024-07-08 04:40:00 +0200Guest2023(~puke@user/puke) (Ping timeout: 268 seconds)
2024-07-08 04:38:09 +0200Guest1123(~puke@user/puke) (Ping timeout: 268 seconds)
2024-07-08 04:36:32 +0200pyooquepuke
2024-07-08 04:36:32 +0200pukeGuest2023
2024-07-08 04:36:31 +0200pyooque(~puke@user/puke)
2024-07-08 04:36:27 +0200td_(~td@i53870918.versanet.de)
2024-07-08 04:35:42 +0200machinedgod(~machinedg@d173-183-246-216.abhsia.telus.net)
2024-07-08 04:35:01 +0200pyooquepuke
2024-07-08 04:35:01 +0200pukeGuest1123
2024-07-08 04:35:00 +0200pyooque(~puke@user/puke)
2024-07-08 04:34:34 +0200td_(~td@i53870903.versanet.de) (Ping timeout: 246 seconds)
2024-07-08 04:34:05 +0200 <joeyadams> For sure. What bad example did you run across?
2024-07-08 04:33:57 +0200 <lain`> yeah, there are some exceptions
2024-07-08 04:30:36 +0200 <joeyadams> I'm going to go out on a limb and say Aeson's documentation is excellent from this standpoint: https://hackage.haskell.org/package/aeson/docs/Data-Aeson.html
2024-07-08 04:24:25 +0200 <lain`> or this https://hexdocs.pm/ecto/getting-started.html
2024-07-08 04:23:18 +0200dysthesis(~dysthesis@user/dysthesis) (Ping timeout: 260 seconds)
2024-07-08 04:20:32 +0200 <lain`> this is good documentation, imo https://learn.microsoft.com/en-us/dotnet/orleans/grains/observers
2024-07-08 04:19:39 +0200 <lain`> s/for/from
2024-07-08 04:19:25 +0200 <lain`> probie: ^
2024-07-08 04:19:19 +0200 <lain`> describing how something works in detail, documentation for each function saying what it's for if it's not obvious, examples of how to use the library in a realish situation, and a guide to learning the concepts of a library for the perspective of someone who doesn't know anything about it
2024-07-08 04:16:07 +0200 <probie> lain`: What counts as decent documentation?
2024-07-08 04:05:24 +0200barthandelous01(barth@triton.blinkenshell.org)
2024-07-08 04:04:26 +0200tomku(~tomku@syn-141-126-184-057.res.spectrum.com)
2024-07-08 04:04:12 +0200tomku(~tomku@syn-141-126-184-057.res.spectrum.com) (Remote host closed the connection)
2024-07-08 04:03:48 +0200barthandelous01(barth@triton.blinkenshell.org) (Ping timeout: 256 seconds)
2024-07-08 03:52:12 +0200barthandelous01(barth@triton.blinkenshell.org)
2024-07-08 03:51:54 +0200barthandelous01(barth@triton.blinkenshell.org) (Ping timeout: 268 seconds)
2024-07-08 03:42:30 +0200hueso(~root@user/hueso)
2024-07-08 03:41:01 +0200peterbecich(~Thunderbi@syn-047-229-123-186.res.spectrum.com) (Ping timeout: 246 seconds)
2024-07-08 03:37:16 +0200 <lain`> i wish there was decent documentation for anything
2024-07-08 03:30:25 +0200peterbecich(~Thunderbi@syn-047-229-123-186.res.spectrum.com)
2024-07-08 03:24:59 +0200L29Ah(~L29Ah@wikipedia/L29Ah) (Read error: Connection timed out)
2024-07-08 03:22:31 +0200AlexZenon(~alzenon@5.139.232.6)