Starting a game now: LWJGL 2 vs 3

[ingframin]

Hello everyone,
I am planning to start the development of a game in the coming days.
- Do you think it is safe to start with LWJGL 3 or is it still not stable enough?
- In case I need to start with version 2.9 is it then very difficult to port it to version 3?
(mostly I mean... will there be some documentation to help the migration between 2.9 and 3.0?
I am not scared of changing my code if I know what I need to change).

Beside this => the example on the homepage of the website does not run anymore with the new build,
I guess it's beacause of the GLCapabilities vs GLContext change.

[Kai]

Hi,
in my opinion, LWJGL3 is really stable right now. There might always be a slim chance that some GL function in some bizzarre extension, which no one used before, was not correctly mapped (missing or wrong-typed parameters).
But more important for me: if you find a bug and report it here or on GitHub, it gets fixed within minutes or at max a day's time.
Even though I would consider LWJGL3 really stable right now, everyone using LWJGL3 is helping that it becomes more stable (if it wasn't already stable enough).
Another thing is that LWJGL3 relies on GLFW for window and GL context management. If there was a bug or misbehaviour in GLFW, the chances that it gets fixed soon are not so pretty. You however always have the possibility to fix it on your own and dynamically link LWJGL3 against your own GLFW build (i.e. just swapping the provided glfw shared library with your own).
However, GLFW allows you to do things that are not possible right now with LWJGL 2.x, for example creating multiple windows and also using OpenGL for Embedded Systems (ES).
That might not be an issue when developing a game (single full-screen window), though.
About porting from 2.x to 3: There is a really nice porting/migration guide for that: https://github.com/LWJGL/lwjgl3-wiki/wiki/2.6.6-LWJGL3-migration

So my advice: All of the development focus and effort is now on LWJGL3, and personally I think it is stable, so start using LWJGL3.