#dev 2020-05-04

2020-05-04 UTC
[tantek], beko, gRegorLove, KartikPrabhu, tomasparks, strugee, [jgarber] and [prtksxna] joined the channel
#
GWG I've been writing docblocks for days now.
#
GWG It has been very instructive, but I'm itching to actually write something that does something.
#
[prtksxna] The old refactor / document vs new feature / bug fix dilemma 😢
#
GWG If I'd been documenting all this time....
#
GWG Either way, the fact that I can't remember what unit of measurement I'm using says I need to document better
#
GWG Am I storing pressure in Hg, mbar, hPa...?
#
GWG I know I'm storing temperature in celsius...
#
GWG So on and so forth.
nickodd and leg joined the channel
#
dansup GWG++
#
Loqi GWG has 26 karma in this channel over the last year (140 in all channels)
gxt, strugee, loicm, swentel, gRegorLove, [tantek], jeremych_, superkuh, [KevinMarks], xsteadfastx and [LewisCowles] joined the channel
#
[LewisCowles] GWG++, what are you using to turn docblocks into documentation? I started using doxygen as it has wide language support and produces documentation in a format I enjoy consuming, with some interesting visualisations of functions to show me "this one is glue, keep looking", this one does something etc.
#
Loqi GWG has 27 karma in this channel over the last year (141 in all channels)
xsteadfastx, hs0ucy, KartikPrabhu, loicm and gxt joined the channel
#
GWG [LewisCowles]: Nothing. Right now I'm just writing them.
#
jeremycherfas Is doxygen the kind of thing that could also help me to understand someone else's programs?
joshghent joined the channel
#
[LewisCowles] Doxygen is for developer-facing documentation and reference manuals as far as I've ever seen it used, but it's theoretically possible to also include content which is not reference manual by adding static assets
#
[LewisCowles] what I quite like about it is that it's giving me call graphs of my code, which allows me to visually see "Oh that has a lot of failure points"
strugee, geoffo and vika_nezrimaya joined the channel
#
GWG [LewisCowles]: I think PHPDocumentor is more popular for PHP code.
#
[LewisCowles] It might be. I try to network benefits as I work in so many languages and I'm using phpdoc syntax
#
[LewisCowles] afaik, my docblocks are the same for both as I don't add `@brief` or similar annotations
swentel joined the channel
#
GWG I'm using WP PHPDoc standard, which don't use brief either
#
GWG But, it's been really helpful in identifying redundant code, actually describing it
[jgarber], IWSlackGateway2, nickodd, hs0ucy, [tantek], [LewisCowles], gRegorLove, [snarfed], jeremych_, strugee, superkuh, [KevinMarks] and loicm joined the channel; nickodd left the channel
#
[tantek] Anyone built anything to (semi-)automatically transition their /Amazon book product links to other providers? E.g. https://www.indiebound.org/book/ (ht: [jeremycherfas]) or https://openlibrary.org/dev/docs/api/covers (ht: [KevinMarks])
#
aaronpk Interestingly there's a service for that: geni.us
#
[KevinMarks] Amazon also cut affiliate fees recently too, so the economic incentive is gone
#
aaronpk its quite expensive
#
aaronpk I want to make my own
#
[KevinMarks] Open Library has a richer dataset than amazon books
#
[KevinMarks] It also has an import from physical book api, but the latency can be high as the endpoint is sending them a copy
#
[tantek] wait what's quite expensive?
#
[tantek] and geni. us didn't seem to have any options to *not* use specific affiliates like Amazon & Walmrt
#
[tantek] I mean I've already built the redirector and am using it at tantek.com/isbn (yes it's a deployment of asin.cc)
#
[KevinMarks] Example import (that I dropped off when I left the US) https://openlibrary.org/works/OL5314431W/Science_and_the_making_of_the_modern_world
#
GWG [tantek]: The more ideas you give me...the more on my itch list
#
[tantek] Sorry not sorry 🙂
strugee joined the channel
#
GWG [tantek]: I wonder if I have any to give you
#
[tantek] GWG, you give me ideas like all the time just by posting about all the stuff you're working on
#
GWG When I see you posting the weather...
#
[tantek] weather? I'm still trying to figure out how to manage location and privacy
#
GWG [tantek]: It is the most niche thing I do
#
GWG [tantek]: As for location, I'd still like someone other than me to adopt location visibility for Micropub
#
[tantek] location visibility? or location blurring?
#
GWG https://github.com/indieweb/micropub-extensions/issues/16
#
Loqi [dshanske] #16 New Property: location-visibility
#
GWG So blurring is 'protected' in that list.
#
GWG I haven't quite figured out blurring in the sense of admitting what city I'm in but not where in it.
#
GWG I should discuss that more
#
Loqi agreed.
strugee joined the channel
#
[KevinMarks] Definition of city is tricky
[snarfed] joined the channel
#
GWG [KevinMarks]: I created zones in my software, which are locations that, if I'm within a certain number of meters of them, it replaces the address with a label and hides the exact location
#
GWG I use this for Home and Work
[tantek]1 and [snarfed] joined the channel
#
[KevinMarks] That makes sense
#
[KevinMarks] The city challenge is working out what is a suitably fuzzy description
#
GWG And a suitably fuzzy set of coordinates
#
GWG Let's say I have a location in London and I want to show a map of the greater area without disclosing where in London I am, how would I derive that from the coordinates?
#
GWG Chop off some decimal points? I currently round to 7, I think
strugee and [mapkyca] joined the channel
#
GWG I'm doing documentation on my location plugin this week, and I've tightened up some of my return arrays, so good time to brainstorm on this
#
jacky so I've just come across mdx and what not
#
jacky it's from the js space (using React components in Markdown)
#
jacky actually hm
#
jacky https://github.com/mdx-js/specification is the spec for mdx
#
Loqi [mdx-js] specification: MDX language and AST definitions
#
jacky I don't know if it's something _I_ could use
#
jacky but I do like the idea for like automatic link conversions into h-cites in a micropub editor
#
jacky versus having to click buttons
[tantek], hs0ucy and strugee joined the channel