Table of content for deliveries 1 and 2

[Fabio Vitali <fabio@CS.UniBO.IT>]

Dear all, 

as discussed in the last TC meeting, the deliverables for this TC will be six (numbered 0 to 5):, as follows: 

0) language primer: a layman introduction to all the issues relevant to the language (Non Normative)
1) language vocabulary: an introduction to the themes, the design issues and the objectives of the language followed by the systematic discussion of the characteristics of each element of the language (Normative)
2) language schema: the formal structure (in XSD and/or RelaxNG) of the XML vocabulary of the language (Normative)
3) naming convention: the structure and components of the URI used in the language (Normative)
4) pilot cases: a list of good experiences and best practices of applying the language to real life situations
5) user manual: instructional material for producers of documents, explaining the steps and the aspects of the actual production of documents using the language.

We are now meant to discuss the Table of Content of these delivery documents. 

With this message, we would like to propose that

A) Delivery 1 has a Table of Content as follows: 

Actual title: The Akoma Ntoso XML vocabulary
Content:
1) Introduction
2) Scope of the language
3) Design issues
4) Basic Akoma Ntoso building blocks
    4.1) The basic structure of Akoma Ntoso XML resources
    4.2) An introduction to document types
    4.3) An introduction to shared elements
    4.4) Basic metadata
    4.5) Analytical metadata and ontological references
5) Akoma Ntoso document types
    5.1) Simple documents
    5.2) Composite documents
    5.3) External fragments
6) Shared elements
    6.1) Containers
    6.2) Block-level elements
    6.3) Semantic inlines
    6.4) Presentation inlines
    6.5) Notes and footnotes
    6.6) Normative references
    6.7) References to concepts and metadata assertions
7) Legislative documents   // (e.g., acts, bills, amendments)
8) Parliamentary documents // (e.g., hansards, minutes, order of the day, etc.)
9) Judiciary documents
10) Contracts
11) Administrative documents
12) Specific features of the language
      11.1) Time and time-related vocabulary
      11.2) Authorship and editorship
      11.3) Linguistic aspects
      11.4) Referencing external datasets, concepts, ontologies
12) Extensions and restrictions to the base vocabulary
13) Compliancy and compliancy levels
14) References


B) Delivery 2 has no proper Table of Content (being a schema), but a general organization in parts as follows: 

Actual title: the Akoma Ntoso schema
1) Simple types
2) Complex types
3) Shared attributes
4) Root and Document elements
5) Legislation-specific elements
6) Parliamentary-specific elements
7) Judiciary-specific elements
8) Contract-specific elements
9) Administrative document-specific elements
10) Shared block-level elements
11) Shared semantic-oriented inline elements
12) Shared presentation-oriented inline elements
13) Shared elements borrowed from other languages (e.g., HTML)
14) Generic elements
15) Metadata elements

Regards and talk to you later

Monica Palmirani
Fabio Vitali

--

Fabio Vitali                            Tiger got to hunt, bird got to fly,
Dept. of Computer Science        Man got to sit and wonder "Why, why, why?'
Univ. of Bologna  ITALY               Tiger got to sleep, bird got to land,
phone:  +39 051 2094872              Man got to tell himself he understand.
e-mail: fabio@cs.unibo.it         Kurt Vonnegut (1922-2007), "Cat's cradle"
http://vitali.web.cs.unibo.it/