ktx icon indicating copy to clipboard operation
ktx copied to clipboard

DOCUMENTATION: clearly needed

Open ghost opened this issue 10 years ago • 12 comments

Is there any type of documentation around?

Trying to setup some coffee break madness for my company. Would like to serve some midair, instagib and so on but there is a great void how to configure msdsv/ktx.

Thanks!

ghost avatar Nov 22 '15 15:11 ghost

There's a wiki on this GitHub page that anyone can update, so it would be nice if we could all come together and try to get some basic documentation up.

niclaslindstedt avatar Nov 26 '15 08:11 niclaslindstedt

I totally agree. Question is though if we should document it here or on quakeworld.nu wiki (that will undergo an upgrade in the near future). Since these projects are rather inactive I think having everything on one place might be more suitable, what do you think? (In general I think that docs should be as close to the src as possible and external parties to link to it, but this is a bit different due to status)

jite avatar Nov 26 '15 09:11 jite

I think the documentation should be here on GitHub.

If we try to keep the pages to a minimum, it can easily be duplicated to QW.nu wiki.

niclaslindstedt avatar Nov 26 '15 09:11 niclaslindstedt

No please no duplication, that's the worst thing to do. As soon as something changes at one place there are two (or more) sources of information that might contradict eachother + it's extra maintenance. The reasonable options IMO are to either host it on github and link from qwnu wiki or host on qwnu wiki and link to it from github.

jite avatar Nov 26 '15 10:11 jite

Then link it here, imo.

niclaslindstedt avatar Nov 26 '15 10:11 niclaslindstedt

Why do you think so? :) My arguments for having docs on wiki:

  • I imagine it's easier for people to find
  • The projects have a tight connection and usually work together so having the documentation in one place would simplify compared to per github project page, since that would mean atleast 4 different places for each module.
  • Repo is rather unmaintained/inactive, it's all up to deurks control and might dissappear anytime (like qw-dev)

jite avatar Nov 26 '15 10:11 jite

The inactivity bit is a good argument, so sure. I agree.

niclaslindstedt avatar Nov 26 '15 10:11 niclaslindstedt

+1 for version controlled documentation. Please don't do it in forums or anywhere else. GitHub pages is great tool and people can fork and continue working if one project decides to quit.

t-my avatar Nov 26 '15 10:11 t-my

@tsoikkel That's the best in the generic case yes but not necessarily in this case. The qw scene is rather focused around quakeworld.nu and ktx/mvdsv aren't used without eachother in 99% of the cases for instance. The quakeworld wiki is "version" controlled in the sense that it's a mediawiki. Requires some thought this :P

jite avatar Nov 26 '15 11:11 jite

Sorry I haven't been following the community for 10 years. Now just popped in and tried to setup a server.

Ended up into:

KTX: http://www.quakeworld.nu/forum/topic/2504/ktx-kombat-teams-extreme-files MVDSV: http://www.quakeworld.nu/forum/topic/2505/mvdsv-multiview-demo-server-files

This is exactly the case when personally hosted services are huge risk to actually losing data.

t-my avatar Nov 27 '15 07:11 t-my

Documentation will be hosted on Github. I will start writing it, any help is of course welcome towards this community effort. It's about time this project gets a decent documentation.

deurk avatar Aug 08 '17 08:08 deurk

Putting that here to not forget to add it to documentation: https://gist.github.com/meag/09b7b6c736b8f2fde1df991cf1151abb https://gist.github.com/meag/b5f3e37777d4e3233cba5df2046d1323

deurk avatar Aug 08 '17 11:08 deurk