Thread Rating:
  • 0 Vote(s) - 0 Average
  • 1
  • 2
  • 3
  • 4
  • 5
Drop dev wiki?
#15
(08-29-2015, 05:21 PM)Simbax Wrote: What does it have to do with my proposition? O_o
Because linking in main README.md and CONTRIBUTING.md to forum is fragmentation of informations. You will need to keep up-to-date those informations in two places at once. And it will be hard to keep those infos in coherent form.

(08-29-2015, 05:21 PM)Simbax Wrote: 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.
Again and again I say that the forum is only for discussions, not official documenting. We can organize and discuss things here, but the main and official informations should be in place DESIGNED for such kind of informations.

(08-29-2015, 05:21 PM)Simbax Wrote: 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.
Most of the people have no time to searching infos about technical aspects of the game in such places like forum. They prefer wiki or GitHub, because forum is for discussions and there's usually a mess of blended and (non)important informations. It's hard to writing and discussing on forum and keep that discussions clean.

(08-29-2015, 05:21 PM)Simbax Wrote: 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.
Why not different READMEs? Every README can be about different technical aspect of the game. When someone will want to contribute in, for example, translations, then he just read TRANSLATING.md and focus on main thing that he need to do and content that he need to provide to us or commit/request himself. The same situation will be when we decide to use GitHub's Wiki. He just go into right page.


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: 3 Guest(s)