h= !License/Availability

Currently, VLO features two facets `License` and `Availability`

There seems to be a lot of confusion what the two facets should contain.
Cleaning up and consolidating this information in VLO is scheduled for the upcoming [https://trac.clarin.eu/milestone/VLO-3.4 VLO-3.4] release. Please consult also issues #812, #813, #814.

== !Facet/Concept Definitions

The two facets and their descriptions/definitions as stated in the [https://github.com/clarin-eric/VLO/blob/master/vlo-commons/src/main/resources/facetConcepts.xml facetConcepts.xml] mapping file

||= facet =||= description =||= definition =||
||  availability  ||  The usage conditions for the resource or tool  || A rough description of the conditions under which the resource or tool can be used  ||
||  license  ||  The licensing conditions for the resource or tool  || The name of the license or a very brief description of the licensing conditions under which the resource or tool can be used  ||


=== Concept Links
||==||==||||=used for facet=||==||==||
||= prefLabel (CCR) =||=Isocat =||= `Availability` =||= `Licence` =||= comment in `facetConcepts.xml` =||= CCR definition =||
||  [http://hdl.handle.net/11459/CCR_C-2457_45bbaa1a-7002-2ecd-ab9d-57a189f694a6 license ] ||  [http://www.isocat.org/rest/dc/2457 DC-2457]  ||  yes   ||  yes   || A description of the licensing conditions || A description of the licensing conditions under which the resource can be used. (source: CLARIN) ||
||  [http://hdl.handle.net/11459/CCR_C-2453_1f0c3ea5-7966-ae11-d3c6-448424d4e6e8 availability] ||  [http://www.isocat.org/rest/dc/2453 DC-2453]  ||  yes   ||  yes   || A description of the terms of availability of the resource in simple words  || A description of the terms of availability of the resource in simple words. (source: CLARIN) ||
||  [http://hdl.handle.net/11459/CCR_C-3800_12a79edd-0ffe-8d82-9831-45d125c54aee licence type] ||  [http://www.isocat.org/rest/dc/3800 DC-3800]  ||  yes   ||  yes   || licenceType: Indication of the type of a copyright licence || Indication of the type of a copyright licence. (source: !NaLiDa) ||
||  [http://hdl.handle.net/11459/CCR_C-6846_d6adb99c-15ac-fac7-7911-f64c48298ce3 rights] ||  [http://www.isocat.org/rest/dc/6846 DC-6846]  ||  (yes) - only isocat link  ||  (yes) - only isocat link || DASISH from DC Rights || Any rights information for this resource. (source: DASISH) ||
||  [http://hdl.handle.net/11459/CCR_C-5439_98bb103d-476a-7f62-54b4-bf9de24d2229 license type] ||  [http://www.isocat.org/rest/dc/5439 DC-5439]  ||  yes   ||  no (commented out)   ||  The DC is used in the distributionType facet || A rights-based classification of language resources and tools, indicating the scope of the target audience (source: CLARIN Deliverable: D7S-2.1, "A report including Model Licensing Templates and Authorization and Authentication Scheme") ||
|| [http://hdl.handle.net/11459/CCR_C-6586_2c79d86a-5a75-0890-d407-7d9cb86b9beb licence URL ] || [http://www.isocat.org/rest/dc/6586 DC-6586] ||  no || yes? (according to email from Menzo, 2015-11-18, but not visible in trunk yet) ||  || URL of a licence (see DC-2457), representing a web location at which the licence text is available. ||
||  ||  [http://purl.org/dc/terms/license dcterms:license ] ||  no (commented out) ||  no (commented out) || ||  A legal document giving official permission to do something with the resource. (source: dcmi) ||

== Normalization of values 

There is already a [https://github.com/clarin-eric/VLO/blob/master/vlo-commons/src/main/resources/LicenseAvailabilityMap.xml normalisation map used in production] (committed 2015-04-23). But there are new values that are not mapped yet. 
[https://drive.google.com/open?id=1Pf8Jk_P7RaA-7-dj8fcLOKNH5DjprraFEWXgQ3FvVtQ Normalisation map as gsheet] with already existing mappings (see normalisation map above) + new values encountered not yet normalized; [[BR]]
Values come from elements annotated with concepts linked to one of the two facets !License/Availability.

See also the [http://clarin.eu/content/license-categories license categories ] as proposed by the ''Legal Issues Committee''.

We propose to map the values to the license categories in decomposed fashion.
I.e. License `CC-BY-SA` would become `["PUB", "BY", "SA"]`.

Allowing multiple possible values for the facet in each record in combination with the (already implemented) multi-select feature in VLO this should cover for all use cases and be more ergonomic (e.g. if I am interested only in the Non-Commercial clause, I need to select only one facet value and don’t have to search for all the combination that contain NC.)

== Missing values

Curently all the mapped concepts only cover around 60.000 records! [http://minerva.arz.oeaw.ac.at/vlo/search?fq=availability:%5Bmissing+value%5D Records with missing value for availability]

Here we have 3 possible situations:
1.	Profile does not have any information about licensing/availability (worst case)
2.	Profile has information about L/A, but is not linked to a concept, or the concept is not in the facet mapping
3.	Profile is well defined, with linking to one of the concepts in the facet mapping, but the information is simply not filled in the record.


Overview of [https://docs.google.com/spreadsheets/d/1eeOr0ShOWxdY8BLzp62LDyfGgHo0gZ95Myw0qauzLxU/edit#gid=0&vpid=A1 profile/facet coverage] with special considerations of availability and licensing facet. Especially also the individual concepts contributing to the facet are plotted (see the `c-*` columns)