6. Document Structure for Instrument-Specific Needs

Peer Zaal in an email exchange on 3 Nov reported concerns related to the organisation of documents visible from the online help facility provided by JIDE. For his HIFI users, he needs a different structure to that presented by the core DP documentation framework. This issue is related to SCR-1687: "It should be possible to move the HCSS main entries of help" (link)

HS mentioned that this issue was raised in the earlier Editorial Board telecon at the end of October, and the conclusion was that this issue should be delayed until after the DP-ALL effort of getting a consolidated build of documentation, software and data is complete.

However, RH felt that a lot of Peer's immediate problems could be solved by making modifications to the core DP documentation framework at HIFI. RH has made similar modifications for the PCSS. RH agreed to discuss this issue directly with Peer at an upcoming visit to Groningen. This resulted in the action:

[Note]AI 031105/1

RH to discuss with Peer Zaal HIFIs problems with organising their documentation from the JIDE help facility. Due 30 Nov 2005.

SG felt that, in spite of the DP-ALL effort, the DP documentation framework was very inflexible and needs to be made more flexible to address future needs by the ICCs. JCG and RH took an action to see ways of improving the flexibility:

[Note]AI 031105/2

JCG/RH to look into ways of improving the flexibility of the DP documentation framework with respect to the organisation of documentation as seen by users through eg the JIDE help facility. Due: 31 Dec 2005.