OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

coel message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: New COEL document review


I have worked my way through the whole document structure with comments off – so there is some overlap with Paul’s existing input.

 

  1. I spent quite a bit of time just on the index which shows that we have some inconsistencies in the level of header we are using in different sections. I don’t think there is anything contentious in the simple changes I would suggest but they will make a lot of red ink without changing any text!

 

  1. The concept of ‘ecosystem’ doesn’t exist outside of the Privacy-by-Design section so I suggest we refer to the ‘architecture’ throughout the main document. This will require a change to the name of section 2 – I suggest ‘The COEL Architecture’. We also need to remove the sub-sections on actors and principles from section 2. I suggest we add a sub-section ‘Ecosystem’ to 11.

 

  1. There is some work to do on : Abstract, Introduction, Objective, Summary of Concepts & Implementations. I think it might help us with the non-normative sections of the rest of the document to do this earlier rather than later. Again the TOSCA document is reasonable starting point.

 

  1. Glossary: needs standardisation & alphabetical order (as it is so long). TOSCA uses this lead-in statement “The following terms are used throughout this specification and have the following definitions when used in context of this document.”

 

  1. Classification of Everyday Living section: I think we need to be clearer about the normative & non-normative content (and specifically what is referenced in the compliance section). The methodology section should be earlier in the overall doc and needs updating. The data flows diagram is now a duplicate and can go. I am still getting a little lost on the split between a correctly structured taxonomy and the specific instance with our content in it. Lastly, I think that the we can only describe the version number (e.g. 1.2) for the COEL Model in this section – the other element has to be done in the BAP (?).

 

  1. Behavioural Atom section: this needs a non-normative introduction (event-based coding) to match the COEL model introduction as these are the 2 key concepts on the standard.

 

  1. Privacy-by-Design section: the normative language needs to be lower case and the requirement need to be stripped back to be only the additional & essential.

 

  1. I expect we can drop section 13 & appendix B.

 

  1. We’ll need to decide how best to format diagrams. In principle, in is nice to have the editable in Word – but it is not really up to the task. I suggest we bring them in as png when we have them finalised.

 

  1. Last, but not least, we need to agree how we use the various COEL terms! I suspect that we need to list all the concepts and then assign the most logical names to them. Personally, I think that should only use the term “COEL Abcd” for an element of the standard that we can define in the glossary. I might avoid ever using “COEL” on its own – referring to the “COEL Specification” when we want to talk about the document as a whole.

 

I hope this helps!

 

Regards

Joss

 

 

 

 

 

Joss Langford

Activinsights | Technical Director

+44 (0)1392 247131 | +44 (0) 7712 886208

www.activinsights.com | www.geneactiv.org

 

Important Information:  The contents of this email are intended for the named addresses only and contain information which is confidential and which may also be privileged.  Unless you are the named addressee (or authorised to receive for the addressee) you may not copy, use it, or disclose it to anyone else.  If you received it in error, please notify us immediately at info@geneactiv.co.uk and then destroy it.  Further, whilst we make efforts to keep our network free from computer viruses, etc., you do need to check this email and any attachments to it for viruses as we can take no responsibility for any viruses which might be transferred by way of this email.

 

Activinsights Limited, 6 Nene Road, Bicton Industrial Park, Kimbolton, Cambs, PE28 0LF, UK.  A company registered in England & Wales. Registered number: 6576069

 



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]