3 ms·
This looks useful as a quick reference and it's very nicely laid out. Nice work! I'm a little disappointed that the text is essentially the same as the man pag
by vitd 11y ago
This looks useful as a quick reference and it's very nicely laid out. Nice work!
I'm a little disappointed that the text is essentially the same as the man pages, which means all the same failings. It would be great if there was actually useful text in there.
For example, this little zinger:
"glBindTexture lets you create or use a named texture."
It mentions in this single sentence that it lets you create a texture, but there's not a single word of that in the rest of the text, leaving you wondering under what circumstances that happens or why or whether you should do it that way normally.
Then we get the opposite in the paragraph about where a texture is first bound:
"When a texture is first bound, it assumes the specified target: A texture first bound to GL_TEXTURE_1D becomes one-dimensional texture, a texture first bound to GL_TEXTURE_2D becomes two-dimensional texture,..."
and on and on for every constant you can pass in.
Anyway, I'd love to see a docs site that fixes these very confusing problems with GL's documentation. This is a great first step, but if you're looking for future directions, consider fixing what's broken in the existing docs!
- BSVino 11y agoHello, dev of docs.gl here. The entire site is here: https://github.com/BSVino/docs.gl https://github.com/BSVino/docs.gl I would love for people help improve the language, which I agree is terrible in places. I don't consider myself an OpenGL expert so I haven't tried to improve the language except in places I know very well. That's why I went for including examples instead of reworking the language. But I would be thrilled if some good writers helped clean it up and expand and clarify etc. Thank you for the feedback. :)