» [14:07:39] <MattJ> Yeah, 99% of guides for Prosody are terrible
» [14:07:55] <MattJ> and I grew to realise this is just true for 99% of all guides for all software setup
» [14:15:53] <pep.> Yes. I keep failing at understanding what people like in unofficial documentations
unofficial documentation is good for getting an idea what what's possible and what you want to do, but you should never rely solely on it
tom
But take a look at the ArchWiki for an example of good unofficial documentation
tom
Unfortunately it's a problem we have nowadays where a lot of 'coders' do not care about learning how things work or the correct way to do things. They just copy-and-paste stack overflow and call it done making somebody else in the company have to fix it later
tom
» <MattJ> In general I think the problem is that guides are either written by developers who know the project too well to make a decent guide, or they are written by random people who wrote the guide while learning how to set it up themselves
maybe look at the Gentoo Handbook for a good example on the steps and procedures needed to make a good guide
sirhas left
jayteeukhas left
jayteeukhas joined
bitzihas left
sirhas joined
pep.
Right, I do use archwiki on a regular basis. I should review my expectations :p
pep.
But archwiki is awesome, there's no denying that!
mike
If I'm looking for some info and I see an archwiki link in the results, it's the first thing I click - and I've never actually used arch ever.
amnesiahas left
sirhas left
sirhas joined
pep.
Yeah you don't need to use Arch to use its wiki
pep.
I have very strong anti-Arch friends who love the wiki :P
mike
this conversation is reminding me that my own "how to set up an xmpp server" guide is nearly five years old and still getting traffic. I really do need to update that or put some big warnings on the pages.
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
mike
The bloody thing includes using StartSSL for certs, and Jappix as a web client heh. I think the prosody config stuff is still pretty solid though.
pep.
things have changed though, you should probably review it nonetheless
mike
Oh definitely, but I think it might be easier to just slap a big "out of date" thing on the pages and write a fresh one.
holgerhas left
holgerhas joined
amnesiahas joined
jayteeukhas left
jayteeukhas joined
bitzihas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kmqhas left
jayteeukhas left
jayteeukhas joined
mightyBroccolihas left
mightyBroccolihas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
amnesiahas left
im0209has joined
404.cityhas joined
lootyhas left
holgerhas left
lootyhas joined
bitzihas left
kusonekohas left
kusonekohas joined
im0209has left
im0209has joined
albrahas left
albrahas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
404.cityhas left
404.cityhas joined
im0209has left
lootyhas left
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
dropshas left
dropshas joined
dropshas left
dropshas joined
dropshas left
dropshas joined
im0209has joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
holgerhas joined
tomhas left
tomhas joined
tomhas left
tomhas joined
im0209has left
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
Huxxhas joined
jayteeukhas left
jayteeukhas joined
paulhas left
sirhas left
sirhas joined
sirhas left
sirhas joined
mimi89999has left
mimi89999has joined
404.cityhas left
insanityhas left
holgerhas left
Pingu from Woodquarterhas joined
kusonekohas left
kusonekohas joined
jayteeukhas left
jayteeukhas joined
kusonekohas left
kusonekohas joined
insanityhas joined
sirhas left
sirhas joined
ibikkhas joined
lorddavidiiihas joined
holgerhas joined
Marandahas left
insanityhas left
jayteeukhas left
jayteeukhas joined
insanityhas joined
sirhas left
insanityhas left
jayteeukhas left
jayteeukhas joined
Nils (10rokita)has left
404.cityhas joined
404.cityhas left
cuchas joined
kusonekohas left
kusonekohas joined
kmqhas joined
kusonekohas left
kusonekohas joined
Nils (10rokita)has joined
Jeybehas joined
schorschhas left
schorschhas joined
Jeybehas left
Jeybehas joined
Jeybehas left
Jeybehas joined
seantoddhas left
seantoddhas joined
Jeybehas left
Jeybehas joined
jayteeukhas left
jayteeukhas joined
jayteeukhas left
jayteeukhas joined
Jeybehas left
Jeybehas joined
Jonnyhas joined
Jeybehas left
Jeybehas joined
Jeybehas left
Jeybehas joined
kusonekohas left
kusonekohas joined
kusonekohas left
kusonekohas joined
kmqhas left
kmqhas joined
kmqhas left
kmqhas joined
insanityhas joined
Jeybehas left
Jeybehas joined
tom
» [17:40:50] <pep.> Right, I do use archwiki on a regular basis. I should review my expectations :p
» [17:41:15] <pep.> But archwiki is awesome, there's no denying that!
» [17:42:56] <mike> If I'm looking for some info and I see an archwiki link in the results, it's the first thing I click - and I've never actually used arch ever.
Speaking of I should probably start backing up archwiki regularly to my hard drives
tom
It's one of those things that i've come to rely on
tom
Need to have some backup if something were to happen to it
tom
Remember when gentoo wiki lost their drives and didn't backup their site?
tom
There are two kinds of computer users. Those that back things up, and those that have never had a hard drive fail yet
jayteeukhas left
jayteeukhas joined
jayteeukhas left
jayteeukhas joined
Jeybehas left
Jeybehas joined
albrahas left
ackerman1scotthas left
ackerman1scotthas joined
ibikkhas left
Jeybehas left
Jeybehas joined
Martin.has left
Martin.has joined
amnesiahas joined
insanityhas left
Jeybehas left
Jeybehas joined
insanityhas joined
bowlofeggshas left
amnesiahas left
jayteeukhas left
jayteeukhas joined
madmalkavhas joined
Jeybehas left
Jeybehas joined
jayteeukhas left
jayteeukhas joined
amnesiahas joined
Ellenor Malik
I'm the third. Those who are too impecunious to afford to make backups.
Jeybehas left
Jeybehas joined
Jeybehas left
Jeybehas joined
Marandahas joined
mss_cyclist
There is a fourth: Those who do not check their backups.