Nested attachments and their work component names

[ed...@laws.africa]

Hi all,

We're marking up nested attachments and I wanted to confirm two things:

1. An Attachment which itself has attachments needs `/main` at the end of its expression URI (but an Attachment without attachments shouldn't have it).

In other words, this would be wrong:

/akn/…/eng@2004-07-21/!schedule_1

…

/akn/…/eng@2004-07-21/!schedule_1/schedule_1

But this would be right:

/akn/…/eng@2004-07-21/!schedule_1/main

…

/akn/…/eng@2004-07-21/!schedule_1/schedule_1

2. The third etc. levels would look something like this:

/akn/…/eng@2004-07-21/!schedule_1/schedule_1/annexure_1

/akn/…/eng@2004-07-21/!schedule_1/schedule_1/annexure_1/schedule_1

/akn/…/eng@2004-07-21/!schedule_1/schedule_1/annexure_2

ref: Hierarchies of components in component specifications (4.8.2 of Naming Convention, https://docs.oasis-open.org/legaldocml/akn-nc/v1.0/os/akn-nc-v1.0-os.html#_Toc531692277)

Thanks in advance!

Edith

[ed...@laws.africa]

Sorry, the examples under 2. should've been:

/akn/…/eng@2004-07-21/!schedule_1/schedule_1/annexure_1/main
/akn/…/eng@2004-07-21/!schedule_1/schedule_1/annexure_1/schedule_1
/akn/…/eng@2004-07-21/!schedule_1/schedule_1/annexure_2

assuming Schedule 1, Annex 2 doesn't have any attachments.

[Edith V]

Hi again all,

We've discussed it internally and decided not to include /main at the end of attachments with nested attachments after all.

Our reasons are:

• As per the AKN specification, the name 'main' is used to indicate that "the component is the only component or the main component in a hierarchy". We will therefore continue to reserve this for the main body of the text (before any attachments).
  
• We do not use '/main' at the end for an attachment without nested attachments, and we don't think the 'main'-ness of an attachment changes based on whether it has children or not.
  
• Adding a nested attachment's name at the end (e.g. annexure_1/annexure_1) is enough to disambiguate the child from the parent.
  

Hope this is helpful for someone, happy weekends!

Edith

--
You received this message because you are subscribed to the Google Groups "akomantoso-xml" group.
To unsubscribe from this group and stop receiving emails from it, send an email to akomantoso-xm...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/akomantoso-xml/3dd0857d-c21f-4994-8bc8-5349bcc12a08n%40googlegroups.com.

--

Edith V

Software developer | Legislative informatician

Laws.Africa