-
tom
» [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
-
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.
-
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.
-
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.
-
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
-
Ellenor Malik
I'm the third. Those who are too impecunious to afford to make backups.
-
mss_cyclist
There is a fourth: Those who do not check their backups.