search

haskell-opengl / OpenGLRaw

Haskell bindings to OpenGL (direct C bindings)
http://www.haskell.org/haskellwiki/OpenGL
BSD 3-Clause "New" or "Revised" License
47 stars 19 forks source link

Missing Hackage documentation #32

Closed ocharles closed 8 years ago

svenpanne commented 8 years ago

Yep, that's a known problem, but none I can solve: As usual, the hackage server has trouble building documentation, other packages I uploaded basically at the same time (GLUT, GLURaw, ...) have their documentation. The documentation itself is fine, see e.g. https://www.stackage.org/package/OpenGLRaw.

I complained about the hackage servers several times in the past (and I'm not alone), but somehow nothing happens, which is really a shame for such a central piece of Haskell infrastructure. Perhaps you can open a ticket in https://github.com/haskell/hackage-server and/or complain in haskell-cafe, the more people raise their voice, the better. I seriously don't understand why generating documentation is that hard, and it's very frustrating... :angry: You can't even see if the building of your documentation has been scheduled or not, or if there was some problem, or... :-P

Note that I refuse to upload docs manually, this is just too much work when you maintain several packages and it's extremely easy to get the links to other package wrong etc.

ocharles commented 8 years ago

Note that I refuse to upload docs manually, this is just too much work when you maintain several packages and it's extremely easy to get the links to other package wrong etc.

Then offload the work to someone else, don't just close the issues! This just suggests you don't seem to care about having users, and this is meant to be a platform package :/ If you need help with maintainership, then grant some other people maintainer rights so they can help you solve these problems.

svenpanne commented 8 years ago

The point is: I consider even the possibility of being able to upload documentation a bug (no guarantee of consistency) and just an ugly workaround for broken infrastructure. I raised the issue several times before, but obviously nobody really cared. It doesn't really make sense to offload the infrastructure maintainer's work to tons of package maintainers (which is effectively what you're proposing).

Stackage always works well regarding documentation, so just follow the Stackage link on http://hackage.haskell.org/package/OpenGLRaw.

svenpanne commented 8 years ago

Just for a laugh: I've uploaded new versions of OpenGLRaw, GLURaw, OpenGL and GLUT, and now only GLURaw has no documentation (but it had it in the previous version). The other packages had their documentation built within minutes. Somehow the scheduling of the doc builder on hackage is fundamentally broken... :stuck_out_tongue: