Fork me on GitHub

I worked through this book on lenses: great read by Clojure/Ruby/OO guy who tries statically typed FP


Hey, does anyone here use Scuttlebutt? How usable is it?


@lady3janepl I've messed around with Patchwork, the social network app built on Scuttlebutt. It's really neat, very easy to set up, there's a lot of interesting posts to see once you join a pub or two.


Thanks @bfay ! I’ve read people talk about how identity is tied to a specific machine you’re on - do you know if there is a way to back it up?


iirc your identity is actually just an ssh key, as long as you have the private key on your pc I... think you can log in with that. But the posts that you see are actually downloaded to disk (so you can view offline). I think they would be redownloaded if you logged in on a new PC, at least up to a certain time limit


You could probably back up that folder, too


Oh, cool, ssh key is backup-able :D


Are there any particular communities that are active on it? I remember G+ was big among pen and paper RPG players for example


Yeah you can search for posts by tag and there's a lot out there - I found some programming and music related things that I was interested in. There seemed to be a lot of members interested in environmental issues, low-power technology, some movement called "solarpunk" that I hadn't heard of before. It's very decentralized and I don't know if you would find something like an organized group to join, but people seemed very welcoming. Definitely no harm in creating an account and trying it out if you want to


Makes sense, coming from creators that seem to be big on living off grid


I’m trying to look for smaller communities, since the main internet is increasingly marketing oriented, and I just don’t have time to compete with rock stars (and ads). I’ll give it a try. Thanks!


It looks like a rebadged Clevo like many Linux laptops


Wow that just triggered some PTSD from BEA Tuxedo! 😳


lol, sorry

😜 4

It’s cool - now I’m brushing off my 90s work playlists. 😉


how/where do people keep internal documentation?

Daniel Hines19:06:14 . We don’t use it as well as we could, but it’s pretty good.


markdown docs in repos for techies, confluence pages for techie-to-non-techie communication


We just had a workshop figuring out pain points for our team (kind of like a retro in a bigger context). Turns out, documentation is our largest one. I work for a company with probably 50 - 100 products that are put together and depend on each other in the wildest ways. So often you have to figure out how some other stuff works, which code belongs to which team, if there is a mailing list where one can ask, etc. Unfortunately every product can document what and how it wants, every product has a product key which is totally not relevant to its product name and the code location and package naming is different too.


We do use confluence and I have to say, it's search is as bad as search can be, I'd guess even altavista was better.


confluence is not good 😞 unfortunately, sometimes familiarity beats usefulness


In our brainstorming session we came up with a few ideas that would make it better and I'd even argue with points that are a must have. • Every thing that is distinguishable and unique becomes one name and this one name is used everywhere. No exceptions. It is used in internal and external documentation, it is part of the package naming, it is part of the code location, it is part of the issue tracker, etc. This is something that enables back and forward navigation and cannot be underestimated. • There should be a must implement guideline on structured documentation that is the same for every thing, again no exceptions. • Part of it is every contact known to that thing. • A solution book with how tos.

👍 4
☝️ 4

And of course a better search


what I found made a difference was a dedicated product person who was good at communication (a philosophy grad 😄 ) and took the time to organise information


Yea, we have a documentation team for our external documentation and they do a good job. But thats not helpful for internal stuff.


its a hard problem it seems 🙂


Definitly. I think the main reasons for this are 1. Documentation grows organically 2. It's an afterthought 3. It's not getting paid.


I think producing and organizing internal documentation is a specialized skill that benefits from dedicated professionals. Only once in my career have I worked with a corporate librarian. 😕