Hydra’s website and wiki have grown somewhat organically during the six years of the project. Both sites (we hope) contain useful information but it is not always clear, especially to newcomers, what detail can be found where and it is not clear that the sites provide the full spectrum of information that our users might need. In addition, some Hydra information resides on Github, alongside our code, and it is not necessarily clear what criteria are or should be used to make this distinction.
Further, there seems to be some reluctance within the Hydra Community to contribute to the Hydra wiki, perhaps because it is not apparent which pages can be freely edited and which pages contain information (possibly quasi-legal) that should not be touched.
The Working Group will set out a basic, complementary structure for each of the three sites – essentially the tables of contents. For the website, one major aim will be to ensure that potential new adopters (be they “senior management,” “managers,” “developers,” or something else) are presented with all the information they initially require in a concise but professional manner. To this end, and to supplement their own ideas, the Group will investigate the websites of a range of comparable organisations to learn from their work. For the wiki, the Group will recommend a logical structure and a mechanism whereby it will be clear to users which pages should not be edited, thus encouraging members of the Community to contribute more freely to the others. Finally, taking guidance from our Developer Community, the Group will try to characterize what constitutes Github content (in addition to Hydra's code) and will indicate what cross-linking there should usefully be between Github, the wiki and the website.
The Working Group is tasked with producing a draft report by mid-March 2015 such that it is available for discussion at the Hydra meetings that will occur later in the spring (LibDevConX, New England Regional meeting, Steering Group). The report might usefully contain:
The Working Group will use the hydra-community (and if appropriate the hydra-tech) mailing lists. Calls are on the first and third Tuesdays of a month at 08:00 PT, 11:00 ET and 16:00 GMT using a conference line at Stanford.
Dial: +1 (530) 881-1400
Access Code: 651025
See right-hand column for past and future calls.
Richard Green (University of Hull)
Jim Tuttle (Duke University)
Tom Cramer (Stanford)
Karen Cariani (WGBH)
Julie Rudder (Northwestern University)
calls 8am PT, 11am ET, 4pm GMT
Questions for Persona Interview (Google Doc)