Re: [dss-x] question regarding the structure of profile documents

[Andreas Kuehne <kuehne@trustable.de>]

Hi Detlef,

thanks for your quick reply!
> I would suggest that the profile documents do not create redundant 
> text (which in the end might be hard to maintain), but only refer to the base documents
> (Core, other profiles).
Yes, redundancy is evil! But we could trade in some convenience as the
referred section would be easy to navigate to. And the redundant parts
will be derived from an authoritative source.
Leaving with the reader with "refer to DSS core, section 'Any'" feels a
bit unpleasant.  Or is there a way to build a link to a section within
another Word document? I haven't found this option.

Greetings,

Andreas
> -----Ursprüngliche Nachricht-----
> Von: dss-x@lists.oasis-open.org <dss-x@lists.oasis-open.org> Im Auftrag von Andreas Kuehne
> Gesendet: Freitag, 30. März 2018 22:55
> An: dss-x <dss-x@lists.oasis-open.org>
> Betreff: [dss-x] question regarding the structure of profile documents
>
> Hi all,
>
>
> I'm just working on the Verification report profile specification to have a version to share with STF 524. Here I came a cross a structural question of a profile document. Especially the Verification profile has many references to the core and other profiles (e.g. AdES profile), 38 components defined in Verification profile, 105 components referenced.
> Should all these referenced elements explained within the profile document? If yes, should the element be fully explained or just be a reference to another document?
>
> >From an implementation point of view the 'full' version is easy to build but it tends to be quite lengthy. On the other hand looking up referenced elements within other documents is quite inconvenient for the reader. See my 'full' working draft attached. Opinions welcome!
>
>
> Have nice holidays,
>
>
> Andreas
>
>
> --
> Andreas Kühne
> phone: +49 177 293 24 97
> mailto: kuehne@trustable.de
>
> Trustable Ltd. Niederlassung Deutschland Gartenheimstr. 39C - 30659 Hannover Amtsgericht Hannover HRB 212612
>
> Director Andreas Kühne
>
> Company UK Company No: 5218868 Registered in England and Wales 
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe from this mail list, you must leave the OASIS TC that 
> generates this mail.  Follow this link to all your TCs in OASIS at:
> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php 
>
>

-- 
Andreas Kühne 
phone: +49 177 293 24 97 
mailto: kuehne@trustable.de

Trustable Ltd. Niederlassung Deutschland Gartenheimstr. 39C - 30659 Hannover Amtsgericht Hannover HRB 212612

Director Andreas Kühne

Company UK Company No: 5218868 Registered in England and Wales