#dev 2026-06-13
2026-06-13 UTC
ggarcia243, jjuran, TwinAdam, ZodiacalComet, grufwub, k3can, joshproehl, ax562, [Sophia_wood], doesnm_, blacklight, chimo, deathcomestotime, deathcomestotim1, oxtyped, [Trevor_Morris], Deakster and proofreed joined the channel
# 
ZodiacalComet [cap]
# ZodiacalComet [capjamesg]: You might also want to look into the u-audio in your podcast, MF2 parsing doesn't fetch the audio URL: https://xray.p3k.app/parse?url=https%3A%2F%2Fweb-weaving.jamesg.blog%2F5&pretty=true
# 
[capjamesg] Oooh yeah I don’t put the u-audio on the home page.
[rose] joined the channel
# 
[rose] I don't know if this is too random for the dev channel, but here goes. I have a few clients who sort of let their email services run away with them, and they have a load of old email addresses they no longer actively use, but keep paying for because they never migrated, or they don't want to migrate for some reason, but they aren't wanting to receive new email. So I've set up a sort of email-archive variant of Dovecot with optional
# [rose] Roundmail for viewing said emails, and integrated imapsync so it can all be moved to and from a real email account. I was wondering if it's worth sharing on github or just not very useful: people who need it probably can't implement it, people who can implement it probably don't need it....
# [capjamesg] I don’t add the audio to the home page because the individual pages have richer context.
# [capjamesg] One way I get around this on my personal site is to have https://jamesg.blog/longform-feed which is a h-feed that contains all of my post contents.
# [capjamesg] I could do something similar here I suppose.
[rose] joined the channel
# ZodiacalComet [capjamesg]: The articles pages themselves have the u-url in the <audio> instead of <source> i mean
# [capjamesg] Ooops my bad.
# [capjamesg] I have just pushed a fix.
# [capjamesg] Let me know if it looks good now!
# [capjamesg] Sorry [Rose] for crowding out your message.
[Al_Abut] joined the channel
# [capjamesg] I have felt a similar tension too in that something being open source doesn’t necessarily mean people can use it.
# ZodiacalComet [Rose]: I would say to publish it even if you don't know that, you never know when someone stumbles upon it and makes their life easier
# [capjamesg] I think that’s good advice ^^
# [capjamesg] No worries! Because we don’t have threads here this happens all the time 😄
# [capjamesg] I don’t think a lot of my open source projects get attention but I am glad they are out there both for personal reference and in case any of the code would be helpful to someone.
# ZodiacalComet [capjamesg]: Looking good in XRay and in mf2py too btw
# [capjamesg] Yayy! ZodiacalComet++ thank you!
# [capjamesg] Are you working on a project that involves feeds / audio?
# [rose] btw James (tagging cos of you mentioning you have multiple OS projects): What level of handholding do you do with your OS project instructions? I'm never quite sure when it comes to supporting stuff like nginx config settings. But I guess I can include my own as an example for people to look at for inspiration...
# ZodiacalComet [Rose]: The paying a lot for something you don't use is crazy to me, how is that possible?
# [capjamesg] That’s a great question. It depends on the project. For some I’ll only add the notes I would need to get the project up and running, but if I think others may want to use the software I will write full installation and setup instructions.
# [capjamesg] https://github.com/capjamesg/jamesql I think shows the kind of format I like to use for a big project.
# [capjamesg] I’ll do intro, sometimes a demo video, installation, quickstart, and usage instructions.
# [capjamesg] That project in particular took me months though so it’s on the more extreme end. Most of the time the README is a couple of hundred words max.
# [capjamesg] I used to maintain technical documentation at work so I kind of love the docs part of a project 😂
# [capjamesg] I was trying to find a more recent example but most of my projects lately have been single HTML files with some JS 😂
# [capjamesg] The simpler, the better 😂
# [capjamesg] Absolutely.
# [capjamesg] I always appreciate when someone hands off a project with clear docs so I can pick it up without losing all the context.
# [rose] Basically a tool to present characteristics about a range of products with weird and wonderful characteristics, with some sorting where appropriate. I've proposed JSON for efficiency and maintainability - but instructions so they don't have to go through their IT team (which is a bit slow) each time might be an option...
# [capjamesg] It has one user: me 😂
# [capjamesg] It works well for blog-size data but nothing bigger, and there’s a technical limitation that would take way too long for me to address.
# [capjamesg] With that said I’m happy!
# [capjamesg] Thank you!
# [rose] I mean, I did go further with instructions with my biggest project, but I ended up being more comfortable away from Github for that content. Again, my bias comes into play - I'm a copywriter/content designer specialised in tech, too, so felt more comfortable when I could control the formats. Susty Icons - an icon set. So I have a page about https://sustyicons.com/understand-the-ui/, and another about
# [capjamesg] I agree that it’s not ideal for many projects to have all their docs on GitHub.
# [capjamesg] I have seen projects with only technical setup instructions on GitHub but most of their content on a website.
# [capjamesg] And thanks for sharing Susty Icons again! I have seen this before but I haven’t used it in a project yet.
# [capjamesg] I love the “green energy flower solid” icon.
# [rose] Some projects suffer for not having the clearest instructions/websites - it's not always better. I tell a lot of people to try out https://www.ventoy.net/en/index.html, but have to sort of persuade them to not judge the tool by the website.
cotsuka, Pixi and deathcomestotim1 joined the channel
kishy joined the channel
# [rose] Thanks for that, [tantek]. Yeah, I think the other problem is that I tend to keep tinkering and tinkering to the point it's not so "portable". What WAS a simple solution has evolved into a bit more - using Dovecot and imapsync for the most useful aspects, but also Roundcube for browsing and cleaning up the archive, plus Authelia to give Roundcube the 2FA it naturally lacks... And suddenly it's more complex.
# ZodiacalComet feature-creep is real
rrix joined the channel
# [rose] Right? So often I make something small and useful and think oh I should share this on GitHub after. But by the time I am done messing with it, it's so tailored to my own system it'd be hard to recommend to others without simultaneously committing to provide support for a few far more complex packags I've integrated…
WinnerWi- and [KevinMarks] joined the channel
# [rose] Wait, I realise there is a short tip to be given here: Authelia is a reaaaally nice FOSS 2FA enabler for any static website or lightweight service that doesn't have 2FA built in. It can also use passkeys. It wasn't tooooo hard to set up and it’s very lightweight. Good for anything when you want a bit more security than basics http auth.
# [rose] Authelia needs a bit of configuring and a subdomain. And it can use just text files for verification, which is fine if you never grant anyone else access. I think my use case will be secure stuff I might want to share with others. Less secure, http auth. Ultra secure, could use headscale… or tailscale! I should probably switch to headscale but that's a whole thing.
bterry joined the channel