| 2024-07-08 00:08:30 +0200 | kraftwerk28 | (~kraftwerk@164.92.219.160) |
| 2024-07-08 00:08:37 +0200 | kraftwerk28 | (~kraftwerk@164.92.219.160) (Remote host closed the connection) |
| 2024-07-08 00:10:31 +0200 | acidjnk_new3 | (~acidjnk@p200300d6e72cfb1245269f140bd925b3.dip0.t-ipconnect.de) (Ping timeout: 268 seconds) |
| 2024-07-08 00:16:58 +0200 | xdminsy | (~xdminsy@117.147.70.231) (Ping timeout: 246 seconds) |
| 2024-07-08 00:21:37 +0200 | takuan | (~takuan@178-116-218-225.access.telenet.be) (Remote host closed the connection) |
| 2024-07-08 00:22:27 +0200 | oo_miguel | (~Thunderbi@78.10.207.46) (Ping timeout: 272 seconds) |
| 2024-07-08 00:23:03 +0200 | emm | (~emm@user/edmeme) (Quit: WeeChat 4.3.3) |
| 2024-07-08 00:28:15 +0200 | gmg | (~user@user/gehmehgeh) (Quit: Leaving) |
| 2024-07-08 00:29:00 +0200 | peterbecich | (~Thunderbi@syn-047-229-123-186.res.spectrum.com) |
| 2024-07-08 00:33:57 +0200 | machinedgod | (~machinedg@d173-183-246-216.abhsia.telus.net) (Ping timeout: 268 seconds) |
| 2024-07-08 00:34:50 +0200 | xdminsy | (~xdminsy@117.147.70.227) |
| 2024-07-08 00:43:34 +0200 | mreh | (~matthew@host86-160-168-12.range86-160.btcentralplus.com) (Ping timeout: 246 seconds) |
| 2024-07-08 00:50:25 +0200 | Tuplanolla | (~Tuplanoll@91-159-69-59.elisa-laajakaista.fi) (Quit: Leaving.) |
| 2024-07-08 00:59:39 +0200 | peterbecich | (~Thunderbi@syn-047-229-123-186.res.spectrum.com) (Ping timeout: 252 seconds) |
| 2024-07-08 01:11:24 +0200 | hueso | (~root@user/hueso) (Ping timeout: 255 seconds) |
| 2024-07-08 01:39:05 +0200 | Guest42 | (~Guest42@2a02-a46b-aaa5-1-b5e3-73be-4d72-a25c.fixed6.kpn.net) |
| 2024-07-08 01:46:52 +0200 | Guest42 | (~Guest42@2a02-a46b-aaa5-1-b5e3-73be-4d72-a25c.fixed6.kpn.net) (Quit: Client closed) |
| 2024-07-08 02:29:55 +0200 | joeyadams | (~joeyadams@2603:6010:5100:2ed:868f:b358:437f:3a21) |
| 2024-07-08 02:31:57 +0200 | califax | (~califax@user/califx) (Remote host closed the connection) |
| 2024-07-08 02:33:27 +0200 | califax | (~califax@user/califx) |
| 2024-07-08 02:42:09 +0200 | nhar | (~noah@c-73-237-54-185.hsd1.ga.comcast.net) |
| 2024-07-08 02:47:30 +0200 | pyooque | (~puke@user/puke) |
| 2024-07-08 02:47:31 +0200 | puke | Guest8981 |
| 2024-07-08 02:47:31 +0200 | Guest8981 | (~puke@user/puke) (Killed (tungsten.libera.chat (Nickname regained by services))) |
| 2024-07-08 02:47:31 +0200 | pyooque | puke |
| 2024-07-08 02:48:05 +0200 | dysthesis | (~dysthesis@user/dysthesis) |
| 2024-07-08 02:50:33 +0200 | nhar | (~noah@c-73-237-54-185.hsd1.ga.comcast.net) (Ping timeout: 268 seconds) |
| 2024-07-08 02:51:55 +0200 | xff0x | (~xff0x@2405:6580:b080:900:c64a:ce6b:6071:dfe5) (Ping timeout: 256 seconds) |
| 2024-07-08 03:05:39 +0200 | waleee | (~waleee@h-176-10-144-38.NA.cust.bahnhof.se) (Ping timeout: 268 seconds) |
| 2024-07-08 03:15:25 +0200 | AlexNoo_ | (~AlexNoo@5.139.232.6) |
| 2024-07-08 03:18:36 +0200 | AlexZenon | (~alzenon@178.34.160.84) (Ping timeout: 268 seconds) |
| 2024-07-08 03:19:07 +0200 | AlexNoo | (~AlexNoo@178.34.160.84) (Ping timeout: 256 seconds) |
| 2024-07-08 03:22:31 +0200 | AlexZenon | (~alzenon@5.139.232.6) |
| 2024-07-08 03:24:59 +0200 | L29Ah | (~L29Ah@wikipedia/L29Ah) (Read error: Connection timed out) |
| 2024-07-08 03:30:25 +0200 | peterbecich | (~Thunderbi@syn-047-229-123-186.res.spectrum.com) |
| 2024-07-08 03:37:16 +0200 | <lain`> | i wish there was decent documentation for anything |
| 2024-07-08 03:41:01 +0200 | peterbecich | (~Thunderbi@syn-047-229-123-186.res.spectrum.com) (Ping timeout: 246 seconds) |
| 2024-07-08 03:42:30 +0200 | hueso | (~root@user/hueso) |
| 2024-07-08 03:51:54 +0200 | barthandelous01 | (barth@triton.blinkenshell.org) (Ping timeout: 268 seconds) |
| 2024-07-08 03:52:12 +0200 | barthandelous01 | (barth@triton.blinkenshell.org) |
| 2024-07-08 04:03:48 +0200 | barthandelous01 | (barth@triton.blinkenshell.org) (Ping timeout: 256 seconds) |
| 2024-07-08 04:04:12 +0200 | tomku | (~tomku@syn-141-126-184-057.res.spectrum.com) (Remote host closed the connection) |
| 2024-07-08 04:04:26 +0200 | tomku | (~tomku@syn-141-126-184-057.res.spectrum.com) |
| 2024-07-08 04:05:24 +0200 | barthandelous01 | (barth@triton.blinkenshell.org) |
| 2024-07-08 04:16:07 +0200 | <probie> | lain`: What counts as decent documentation? |
| 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:19:25 +0200 | <lain`> | probie: ^ |
| 2024-07-08 04:19:39 +0200 | <lain`> | s/for/from |
| 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:23:18 +0200 | dysthesis | (~dysthesis@user/dysthesis) (Ping timeout: 260 seconds) |
| 2024-07-08 04:24:25 +0200 | <lain`> | or this https://hexdocs.pm/ecto/getting-started.html |
| 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:33:57 +0200 | <lain`> | yeah, there are some exceptions |
| 2024-07-08 04:34:05 +0200 | <joeyadams> | For sure. What bad example did you run across? |
| 2024-07-08 04:34:34 +0200 | td_ | (~td@i53870903.versanet.de) (Ping timeout: 246 seconds) |
| 2024-07-08 04:35:00 +0200 | pyooque | (~puke@user/puke) |
| 2024-07-08 04:35:01 +0200 | puke | Guest1123 |
| 2024-07-08 04:35:01 +0200 | pyooque | puke |
| 2024-07-08 04:35:42 +0200 | machinedgod | (~machinedg@d173-183-246-216.abhsia.telus.net) |
| 2024-07-08 04:36:27 +0200 | td_ | (~td@i53870918.versanet.de) |
| 2024-07-08 04:36:31 +0200 | pyooque | (~puke@user/puke) |
| 2024-07-08 04:36:32 +0200 | puke | Guest2023 |
| 2024-07-08 04:36:32 +0200 | pyooque | puke |
| 2024-07-08 04:38:09 +0200 | Guest1123 | (~puke@user/puke) (Ping timeout: 268 seconds) |
| 2024-07-08 04:40:00 +0200 | Guest2023 | (~puke@user/puke) (Ping timeout: 268 seconds) |
| 2024-07-08 04:43:59 +0200 | terrorjack | (~terrorjac@2a01:4f8:c17:87f8::) (Quit: The Lounge - https://thelounge.chat) |
| 2024-07-08 04:45:38 +0200 | dyniec | (~dyniec@dybiec.info) (Quit: WeeChat 4.2.2) |
| 2024-07-08 04:45:55 +0200 | terrorjack | (~terrorjac@2a01:4f8:c17:87f8::) |
| 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: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:54:31 +0200 | <lain`> | in general |
| 2024-07-08 05:04:47 +0200 | euleritian | (~euleritia@dynamic-176-003-015-111.176.3.pool.telefonica.de) (Read error: Connection reset by peer) |
| 2024-07-08 05:05:05 +0200 | euleritian | (~euleritia@77.22.252.56) |
| 2024-07-08 05:09:37 +0200 | euleritian | (~euleritia@77.22.252.56) (Read error: Connection reset by peer) |
| 2024-07-08 05:10:13 +0200 | euleritian | (~euleritia@77.22.252.56) |
| 2024-07-08 05:11:51 +0200 | aforemny | (~aforemny@2001:9e8:6ce5:1500:7cdb:cdf7:8d8:ba53) |
| 2024-07-08 05:13:07 +0200 | aforemny_ | (~aforemny@2001:9e8:6cc4:ed00:8551:e69c:b7dd:ec64) (Ping timeout: 260 seconds) |
| 2024-07-08 05:16:51 +0200 | bitdex | (~bitdex@gateway/tor-sasl/bitdex) |
| 2024-07-08 05:18:14 +0200 | xdminsy | (~xdminsy@117.147.70.227) (Ping timeout: 268 seconds) |
| 2024-07-08 05:19:07 +0200 | xdminsy | (~xdminsy@117.147.70.227) |
| 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:27:55 +0200 | <EvanR> | as god intended |
| 2024-07-08 05:44:45 +0200 | euleritian | (~euleritia@77.22.252.56) (Ping timeout: 268 seconds) |
| 2024-07-08 05:44:53 +0200 | euleritian | (~euleritia@dynamic-176-003-015-111.176.3.pool.telefonica.de) |
| 2024-07-08 05:48:37 +0200 | JimL | (~quassel@89.162.16.26) (Quit: https://quassel-irc.org - Chat comfortably. Anywhere.) |
| 2024-07-08 05:51:31 +0200 | pyooque | (~puke@user/puke) |
| 2024-07-08 05:51:31 +0200 | puke | (~puke@user/puke) (Killed (erbium.libera.chat (Nickname regained by services))) |
| 2024-07-08 05:51:31 +0200 | pyooque | puke |
| 2024-07-08 05:51:41 +0200 | JimL | (~quassel@89.162.16.26) |
| 2024-07-08 06:07:04 +0200 | puke | Guest7691 |
| 2024-07-08 06:07:04 +0200 | pyooque | (~puke@user/puke) |
| 2024-07-08 06:07:04 +0200 | Guest7691 | (~puke@user/puke) (Killed (tungsten.libera.chat (Nickname regained by services))) |
| 2024-07-08 06:07:04 +0200 | pyooque | puke |
| 2024-07-08 06:08:39 +0200 | Square | (~Square@user/square) (Ping timeout: 260 seconds) |
| 2024-07-08 06:11:58 +0200 | euleritian | (~euleritia@dynamic-176-003-015-111.176.3.pool.telefonica.de) (Read error: Connection reset by peer) |
| 2024-07-08 06:12:15 +0200 | euleritian | (~euleritia@ip4d16fc38.dynamic.kabel-deutschland.de) |
| 2024-07-08 06:13:26 +0200 | smalltalkman | (uid545680@id-545680.hampstead.irccloud.com) |
| 2024-07-08 06:19:28 +0200 | euleritian | (~euleritia@ip4d16fc38.dynamic.kabel-deutschland.de) (Read error: Connection reset by peer) |
| 2024-07-08 06:19:55 +0200 | puke | (~puke@user/puke) (Ping timeout: 268 seconds) |
| 2024-07-08 06:25:16 +0200 | xff0x | (~xff0x@2405:6580:b080:900:7a48:d908:3a13:a68a) |
| 2024-07-08 06:27:08 +0200 | euleritian | (~euleritia@ip4d16fc38.dynamic.kabel-deutschland.de) |
| 2024-07-08 06:55:59 +0200 | machinedgod | (~machinedg@d173-183-246-216.abhsia.telus.net) (Ping timeout: 268 seconds) |
| 2024-07-08 07:08:16 +0200 | <Axman6> | lain`: many libraries rely heavily on types, and lens is a good example of that; many of the types tell you a lot about what they could possibly do, without needing to explain much in words - but learning how to know what the types mean is something that takes time and use of the library. The basics of lens are trivial, but it is a library with a very broad range of applications, and in many cases a lot of depth too. |
| 2024-07-08 07:12:41 +0200 | <lain`> | i mean, people won't nessecarily intuit the depth, even if it's intended to be used that way by the authors. |
| 2024-07-08 07:13:28 +0200 | <lain`> | even if what a function literally does is understandable, why it's there and what place it has in the design isn't always obvious. i think that's the kind of thing that examples and tutorials can help with. |
| 2024-07-08 07:18:27 +0200 | <lain`> | the lens readme doesn't even say what a lens *is*. |