[torqueusers] Retiring the TORQUE Wiki
Josh Butikofer
josh at clusterresources.com
Mon Nov 3 16:14:14 MST 2008
Everyone,
As I'm sure many of you have noticed we have several "versions" or
"flavors" of documentation for TORQUE: we have normal HTML docs, wiki
docs, a PDF, and now an improved version of the HTML docs. We initially
had only the HTML docs, but after repeated requests from the community
for a editable wiki, we created the wiki docs. The improved HTML docs
are designed to facilitate better navigation and information retrieval.
After having the TORQUE wiki operational for more than two years we are
now coming to a crossroads. We would like to make all of our
documentation standardized and consistent across the software we
host/produce. The improved version of the HTML docs has been met with
positive feedback and we will be making these the de facto TORQUE docs.
The wiki docs, on the other hand, have proved troublesome in that they
must be synced up with the HTML docs. Also, the wiki docs have not
enjoyed as many contributions from the community as was initially hoped
for; for example, the last community improvement made to the docs was
made in January of this year. In short, the wiki is not meeting the
original goal to improve the TORQUE documentation.
With the hiring of full-time TORQUE developers, and a growing
documentation staff, we believe that moving away from a wiki and
consolidating around normal HTML documentation will be best. We will
provide a convenient e-mail address which can be used to submit
suggested content changes. Although not as immediate as a wiki, this
will still allow the community to contribute to the improvement of the
TORQUE docs.
We are interested in hearing community feedback about this decision.
Please let us know what you think.
Thanks,
--
Josh Butikofer
Cluster Resources, Inc.
#############################
More information about the torqueusers
mailing list