Thread Rating:
  • 0 Vote(s) - 0 Average
  • 1
  • 2
  • 3
  • 4
  • 5
Drop dev wiki?
#13
(08-29-2015, 11:41 AM)RaptorParkowsky Wrote: You will be keeping files on repo up-to-date?
or
You will be keeping files on repo && posts on forum up-to-date?

What does it have to do with my proposition? O_o

If you suggest that we will not keep the documentation we are talking about up-to-date then it does not depend on the subject at all, it only depends on TerranovaTeam. Doesn't matter if the documentation is on GitHub, in-game or wherever.

(08-29-2015, 11:41 AM)RaptorParkowsky Wrote: Again, the forum is a good place for discussions and setting the rules of ICC (good example of topic about rules: http://colobot.info/forum/showthread.php...03#pid5903), but not for documentation.

Why not? I'd consider it actually a better place because of marking threads as unread after editing. We have so many commits a day and so much spam at IRC that there is a high probability of missing the update of the documentation.

(08-28-2015, 09:29 PM)RaptorParkowsky Wrote: Nobody will searching infos about compiling GOLD on some exotic platform on forum, where one important information can be often camouflaged by textwall.

That's surprising, because when I'm searching for something I firstly check a wiki and forums. Honestly, most of the time there is little, if any, useful information in all these README files. But maybe that's just me.

Also, we already have so many READMEs in many different folders, that it's confusing. Sticky threads on forum or properly maintained wiki are way better in my opinion. And they're much easier to modify, as one do not need to use git and no one will be afraid of fixing some typos or minor updates because of "nah, I'll fix it when there will be something important to update". Also I don't think that spamming with commits "Update documentation" on the main game repository is a good idea.

So my vote goes for forum or GitHub wiki, does not make much difference for me. I'm definitely against keeping ALL documentation in the repository. It's not a place for that, it's for the source code.
[Image: XvN5CTW.png] [Image: UYXyyMS.png]


Messages In This Thread
Drop dev wiki? - by piotrdz - 08-28-2015, 05:34 PM
RE: Drop dev wiki? - by tomangelo - 08-28-2015, 05:58 PM
RE: Drop dev wiki? - by RaptorParkowsky - 08-28-2015, 06:14 PM
RE: Drop dev wiki? - by tomangelo - 08-28-2015, 09:09 PM
RE: Drop dev wiki? - by RaptorParkowsky - 08-28-2015, 09:29 PM
RE: Drop dev wiki? - by tomangelo - 08-29-2015, 12:00 AM
RE: Drop dev wiki? - by Simbax - 08-29-2015, 06:13 AM
RE: Drop dev wiki? - by krzys_h - 08-29-2015, 09:25 AM
RE: Drop dev wiki? - by Simbax - 08-29-2015, 11:25 AM
RE: Drop dev wiki? - by RaptorParkowsky - 08-29-2015, 11:41 AM
RE: Drop dev wiki? - by tomangelo - 08-29-2015, 01:25 PM
RE: Drop dev wiki? - by krzys_h - 08-29-2015, 02:26 PM
RE: Drop dev wiki? - by Simbax - 08-29-2015, 05:21 PM
RE: Drop dev wiki? - by krzys_h - 08-29-2015, 07:23 PM
RE: Drop dev wiki? - by RaptorParkowsky - 08-30-2015, 12:28 PM
RE: Drop dev wiki? - by tomangelo - 08-30-2015, 12:51 PM
RE: Drop dev wiki? - by Simbax - 08-30-2015, 03:41 PM
RE: Drop dev wiki? - by piotrdz - 08-30-2015, 06:49 PM
RE: Drop dev wiki? - by Simbax - 08-30-2015, 07:27 PM
RE: Drop dev wiki? - by piotrdz - 08-30-2015, 10:08 PM
RE: Drop dev wiki? - by tomangelo - 08-30-2015, 10:38 PM
RE: Drop dev wiki? - by Simbax - 11-24-2015, 04:31 PM

Forum Jump:


Users browsing this thread: 2 Guest(s)