Not sure if this is the best place to put this post...
IMO, I think that it'd be best to just merge the outdated links at the main LWJGL home page into the Wiki and either remove them from the homepage or redirect to the wiki.
Those would be:
http://lwjgl.org/faq.php (merge into here: http://lwjgl.org/wiki/index.php?title=General_FAQ)
http://lwjgl.org/installation.php (outdated)
http://lwjgl.org/documentation.php (merge into wiki, since wiki is supposed to be documentation anyway)
At the very least, installation.php should go. It's outdated and confuses new users when they try the outdated information and then doesn't work. By merging it with the Wiki, we could keep it up-to-date as a community, or just admins could have correct privileges to update it.
Other things could really be merged into the Wiki as well, like projects and demos, and that way both of those would be up-to-date as well.
What do you think?
I agree - the more we can move to the wiki, the better.
We need to make a list of which pages goes where (similar to the 3 things you made).
My concern with the projects page is if someone abuses it somehow. Right now all projects are randomized - in the wiki everybody would be free to add it to the top. also some might use bigger images etc.
yeh good idea, agree, that the installation, faq, documentation and links pages should go.
The FAQ page is now out of date, I've merged the useful bits into the wiki faq and the page can now be deleted.
Installation Page as mentioned above is also out of date, there is a new tutorial for Eclipse on the wiki, however there is nothing yet for Netbeans and JCreator, not sure if the installation page instructions still work for those but once we have replacements on the wiki it should be OK to remove (maybe we can just move the current netbeans and jcreator stuff over).
Links page is also out of date (misses lots of new stuff) and should be moved to the wiki.
Moved the LWJGL Constitution About Page to the Wiki now, so that can get the chop too.
Its a bit inaccurate these days so could use a slight update too :)
<random radical thought> at this rate doesn't look too hard to just move the whole site over to mediawiki :)</random radical thought>
I added a NetBeans tutorial:
http://lwjgl.org/wiki/index.php?title=Setting_Up_LWJGL_with_NetBeans
It might be way too thorough, but I was thinking of the complete newbie when I wrote it, so I'm thinking we're good with NetBeans stuff.
Quote from: jediTofu on December 09, 2010, 08:09:16
I added a NetBeans tutorial:
oh brilliant, really nicely done tutorial, at this rate we'll have a full set of documentation in no time.
Currently working on a full slick-util tutorial here, hopefully will post it sometime later today.
Awesome! Definitely need a Slick-Util tutorial.
I moved http://lwjgl.org/installation.php to here (Testing LWJGL section):
http://lwjgl.org/wiki/index.php?title=Downloading_and_Setting_Up_LWJGL
I changed it a tiny bit and updated it.
I did a straight copy & paste of JCreator's installation here:
http://lwjgl.org/wiki/index.php?title=Setting_Up_LWJGL_with_JCreator
http://lwjgl.org/installation.php can be axed now if everyone approves.
I added a tutorial to use TWL's PNGDecoder (http://lwjgl.org/wiki/index.php?title=Loading_PNG_images_with_TWL's_PNGDecoder) to the wiki.
I will update links to point to wiki where appropriate. I am still not sure the projects listing will work on wiki tho ..
On the Main Page (http://lwjgl.org/wiki/index.php?title=Main_Page), I added a Miscellaneous section with Links & Resources outside of LWJGL. Mainly, I think that it's important that we have an up-to-date list of the game engines using LWJGL. Links & Resources page (http://lwjgl.org/wiki/index.php?title=Links_%26_Resources). It looks a bit sloppy right now, and I hope it's intuitive for new users to find it in the Miscellaneous section. I thought about putting it in the "Getting Started" section on the main page, but didn't want users to go there first instead of looking at the tutorials provided at the main page. Best place to put Links & Resources ???
@Matthias, Cool stuff. I changed your pre's to use the java brush. If you didn't want this, you can change it back of course. I also added a link to your TWL and PNGDecoder to Links & Resources page.
@Matzon, I agree unless there is a way to restrict editing the page to admins only. But, if someone has a new project using LWJGL, it would be nice to be able to add it without relying on admins; the Links & Resources page should be an adequate fix for this right now.
Kind of a new problem that's annoying: google isn't picking up LWJGL's wiki tutorials first when searching "lwjgl tutorials", "lwjgl netbeans", "lwjgl eclipse", etc. Stupid google :(
@jediTofu nice work with the new bit on the wiki, took some time to help tweak it a bit more. However still needs further work but guess its slowly getting there. The more ppl working on it the better, feel free to continue updating it as you like.
Quote from: jediTofu on December 11, 2010, 01:12:29
Kind of a new problem that's annoying: google isn't picking up LWJGL's wiki tutorials first when searching "lwjgl tutorials", "lwjgl netbeans", "lwjgl eclipse", etc. Stupid google :(
It'll get it eventually but the stuff's still relatively new.
Nice, that looks a lot better. What's left to do?
Quote from: jediTofu on December 11, 2010, 00:47:06
@Matthias, Cool stuff. I changed your pre's to use the java brush. If you didn't want this, you can change it back of course. I also added a link to your TWL and PNGDecoder to Links & Resources page.
Nice - I didn't find this on the wiki help. But it doesn't do syntax highlighting?
Full (4 part!) Slick-Util Tutorial is now up. :)
Quote from: Matthias on December 11, 2010, 23:57:54
But it doesn't do syntax highlighting?
It does, but its very basic.
Quote from: jediTofu on December 11, 2010, 23:35:05
What's left to do?
- Something on OpenCL would be nice, even if its basic (have no idea on what or how to use that).
- Something on using JInput would also be cool.
- Java Web Start with LWJGL.
- Building LWJGL from source.
- Using LWJGL's extension stuff (with jws and applets).
- Tutorials to cover various advanced topics (Shadows, VBO, FBO, PBO, etc).
- but generally the more stuff the better :)
I think we've transferred all (most) the wikifiable information (and updated it to an extent) from LWJGL's website over to the wiki, so guess the site can be cleared up of the outdated stuff (namely the About, Installation, Documentation, FAQ and Links Pages).
Quote-Building LWJGL from source
I was going to write something up about this, but I couldn't figure out how to get it to work. Someone who actually compiles/builds the source regularly will have to help, as there is virtually no documentation or hints.
Obviously, it uses ant. I tried just running the default target, but it complains about missing Mac OS X files, which makes since because I'm on Linux currently. Doing "ant -p" doesn't show any OS-specific targets. Looking through build.xml, there are OS-specific targets, but I don't feel like searching for all of them and figuring out what needs to go first, etc. It should just be shown in "ant -p" anyway. I then tried running the ant build script in platform_build/linux_ant. It then complained about missing C headers files I believe. I have gcc (and g++), make, java, etc. all installed, so I don't know what else I would need to install and where.
Any help on this?
Nice, just noticed that the front page side links now link to the wiki pages :)
btw just some thoughts:
1) The 'Installation' link points to the same place as 'Documentation', maybe it should be removed since its not technically the correct word and gives some newbies the impression that you actually manually install LWJGL on your computer, besides the 'Documentation' link on its own should be sufficient.
2) Front Page Introduction should be updated to reflect that OpenCL is now also support.
In order to chase the (never ending :)) goal to get the bug count to 0, i'll mark this as fixed as the links on the front page have now been amended to point to wiki.