Sorry for the late reply, my work takes priority and I've been pretty busy.
Just remember, these are all opinions. Opinions are like assholes, everyone has one and they all stink. I'm an old man, I hate a lot of the direction things are going in these days.
paroj wrote: ↑
Mon Nov 06, 2017 12:31 pm
so is github - just better suited for code related thigs
Sure, but it is also designed as a code repo, not for documentation. It would require me to pull things, fork things, look at branches, etc. All on a horrible web 2.0 centric UI design which is made for programmers getting code, not for a person reading a manual. Too many barriers for a novice programmer, too many layers for those of us that just want a quick answer.
To me a Doxygen is an official documentation. It is not made for my musings about sales figures of Ogre games for example. Nor is it for a wide variety of information, useless projects, list of random things, documentation, and code examples. Doxygen to me is for well organized, structured, manual. I am not one to contribute to it. The official Ogre team is.
Yes, users can submit things, but I think it will ultimately cut down on the submissions. The quality and organization would be improved however. I know I would have never submitted the Ogre sales list to a dyoxgen. Nor would I expect to find half of the useful and useless information you run across on the wiki. I guess all of that should be done on the forums alone now.
So switching to Doxygen is just a simple Quantity or Quality solution. Doxygen will improve your quality, but will reduce your quantity, because you will not get as many submissions in my opinion.
I know I will not submit if my work has to be approved, accepted, merged, pulled, or whatever you kids wanna call it these days.
Looks very documentation like. Great for official stuff, but I'm not going to touch it or write well enough that I would would want to submit my work for someone else to peer review. Quality vs Quantity.
editing that is just as easy as going to https://github.com/OGRECave/ogre/edit/m
It will even guide you through the process of forking and creating a pull-request. You can do everything in the browser - just like with the wiki.
Sorry, but NO. I'm not forking a damn thing on github just to fix a broken link or something. I have zero interest in duplicating your project on my account. I wouldn't even have a github or use git if I could avoid it. (Self hosted Trac and SVN for the win!)
And that's fine for Official documentation (although I think the idea of having it on a third party platform is stupid). However I am not going to go through all that effort and work to fix errors or write my own information. I would never sign up for a github account or any other large thirdparty data collection service if I could avoid it. That's just me.
As you see we still have too much choice here
If the dev team only knew. We have a little bot on IRC, named Veda. Most of the questions we get can quickly be answered asking her. In the Ogre Root question above, !ogrewiki practical application. Bam, all the questions the user has answered.
But even if it would not belong in the main repo, I would at most create an additional OGRECave/snippets project which would be the kitchen-sink for everything. No need for hundreds of forks.
Again, as someone who hates git, github, etc. Looking around various github snippets would be annoying as well. But if that's the "in" thing these days, guess I can't avoid it.
I though you already have a script to generate that table? anyway lets take one step at a time. First the stage, then the automation. In any case that script should run locally on your machine and not on the ogre servers.
I do not have a script, I avoid web programming like the plague. I type everything in manually for the charts. (The list grew much larger than I expected...) There is a steamspy API which returns the results as JSON. Since I hate anything with the word "java*" in it, I have zero interest in learning how to pull the data out of it (short of just reading the raw string in C) and displaying it. I asked on the forum if anyone was interested in writing something to do it dynamically, but got no takers.