# Release Notes for Nacaps 2018

All notable changes to this data package will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).

## Unreleased
-

## [2.0.0] - 2024-04-30

### Added
-	data:
	-	wave 1:
		-	variables adbi15_g0, adbi15_g1, aedb04b_g1, aedb04b_g4 and adbi10a_g1 were added (but only to document their existence; in the data, these variables contain the missing "anonymized" for each access way)
		-	variable alcd08_g1 was added (useable via access ways "SUF: On-Site" and "SUF: Remote-Desktop")
	-	wave 2-4 (de/en) (integrated into one data set together with data of wave 1)
-	documentation:
	-	structured metadata in the search portal at levels:
		-	surveys (de/en) (wave 2-4)
		-	instruments (de/en) (wave 2-4)
		-	questions (de/en) (wave 2-4)
		-	variables (de/en) (wave 2-4 and additions for added variables in wave 1 (see above))
		-	concepts (de/en) (wave 2-4 and partial additions for wave 1)
	-	attached metadata in the search portal:
		-	data and methods report (en) (wave 1-4)
		-	variable questionnaire (de/en) (wave 2-4)

### Changed
-	data:
	-	ID-variable id_suf was renamed to pid
	-	data set is sorted by pid
	-	variable labels
		-	for all variables, the access way information at the end of the variable label has been removed
		-	additionally variable labels were changed for the following variables:
			-	adsv12a
			-	afin01k
			-	afin02j
			-	afin04j
			-	aedb04b_g2
			-	aedb04b_g3
			-	aedb04b_g4
			-	adem02_g1
			-	adem02_g2
			-	aedb02_g1
			-	aedb02_g2
			-	aedb04b_g5
			-	aedb04b_g6
			-	aedb04d_g2
			-	aedb04h_g1
			-	aedb04h_g2
			-	adwr02p
			-	apar05a_g4 (only English translation)
			-	apar05a_g5 (only English translation)
			-	apar05a_g6 (only English translation)
			-	apar05b_g4 (only English translation)
			-	apar05b_g5 (only English translation)
			-	apar05b_g6 (only English translation)
			-	(for some other variables, minor corrections have been made (e. g. removal of unnecessary blanks))
	-	value labels
		-	names of the following value label containers have been changed:
			-	acdc07a_labelset becomes adcd07a_labelset
			-	acdc07a_labelset_en becomes adcd07a_labelset_en
			-	acdc07b_labelset becomes adcd07b_labelset
			-	acdc07b_labelset_en becomes adcd07b_labelset_en
			-	acdc07c_labelset becomes adcd07c_labelset
			-	acdc07c_labelset_en becomes adcd07c_labelset_en
			-	genannt becomes genannt_weltregion
			-	genannt_en becomes genannt_weltregion_en
		-	value label containers landlabelset and landlabelset_en have been extended by the following values:
			-	193 (Svalbard und Jan Mayen/Svalbard and Jan Mayen)
			-	333 (Dominica)
			-	392 (Niederländische Antillen/Netherlands Antilles)
			-	398 (Französische Überseegebiete in Amerika/French Overseas Territories in America)
			-	459 (Palästinensische Gebiete/Palestinian territories)
			-	465 (Taiwan)
		-	in value label container staatsblabelset_en category "Nigerian" was changed to "Nigerien" (for code 255)
		-	in value label containers apar08a_g1_labelset and apar08b_g1_labelset category "Sonstiges" was changed to "anderer Schulabschluss"
		-	in value label containers apar08a_g1_labelset_en and apar08b_g1_labelset_en category "Other" was changed to "other school-leaving certificate"
		-	in value label containers apar10a_g1_labelset and apar10b_g1_labelset category "andere Abschluesse" was changed to "anderer Ausbildungsabschluss"		
		-	in value label containers apar11a_g1_labelset and apar11b_g1_labelset category "andere" was changed to "andere berufliche Stellung"
		-	in value label containers apar11a_g1_labelset_en and apar11b_g1_labelset_en category "other" was changed to "other professional status"
		-	the Englisch translation of value label containers of the subject variables (adbi15_g* and aedb04a_g*) have been revised for several values
		-	for some value label containers, unnecessary blanks have been removed from the value labels
	-	recoding
		-	some missing codes were recoded to other missing codes to better fit the missing system
		-	recoding was done if in multiple responses with open-ended questions the variable for the open-ended statement was filled, but the associated variable of the closed sub-question was incorrectly not coded to 1
		-	recoding of variables with the value label container landlabelset(_en) was done, because in some cases incorrect values had been assigned
		-	for the following variables, the appropriate missing values were assigned (variables had previously only been coded 0/1, missings had received the value 0):
			-	aabr03_g15-aabr03_g19
			-	adem10_g7-adem10_g11
			-	apar05a_g7-apar05a_g11
			-	apar05b_g7-apar05b_g11
			-	aedb01b_g4-aedb01b_g8
		-	for variables adbi15_g2 and adbi15_g3, some assignments to a subject group were changed and furthermore some additional subject group codes could be assigned (previously "not determinable") 
		-	variables adbi15_g2 and aedb04_g2 (both destatis subject group variables) contain the codes 1-8 instead of the codes 1-5 resp. 7-9 (without code 6) now
	-	some variables have been reordered
-	documentation:
	-	structured metadata in the search portal at levels:
		-	data package (de/en): changes due to the addition of waves 2-4; addition of links
		-	data sets (de/en): changes due to the addition of waves 2-4 and additions/removals in wave 1 (see above and below)
		-	questions (wave 1): some corrections have been made, especially to the images but also to some texts and to the sequence of questions
		-	variables (wave 1):
			-	changes in data edition (see above) exist accordingly here
			-	some scale levels were changed
			-	generation details for generated variables were revised
			-	some texts of related questions were revised
	-	attached metadata in the search portal:
		-	release notes have been updated
		-	data and methods report (de):
			-	information on wave 1 was revised (especially chapter 2, 6 and 8)
			-	changes due to the addition of waves 2-4
		-	overview (de/en): changes due to the addition of waves 2-4 and case deletions in wave 1 (see below)
		-	variable questionnaire (de/en) (wave 1): variable questionnaires on wave 1 were revised
		-	dataset report (de/en)
			-	changes in data edition and structured metadata on level variables in wave 1 (see above) exist accordingly here
			-	changes due to the addition of waves 2-4

### Removed
-	data:
	-	19 cases were deleted at own request (5 of these were part of the CUF subsample)
	-	the following variables were deleted:
		-	all flag-Variables (with suffix *_flag)
		-	various variables with uncoded open responses that were only in data set to document their existence (in the data, these variables contained the missing "anonymized" for each access way)
			-	adid01
			-	adid02
			-	adbi10a
			-	adbi10b
			-	adbi15
			-	aabr03
			-	adem04
			-	adem05b
			-	adem10
			-	apar02a
			-	apar02b
			-	apar05a
			-	apar05b
			-	apar07a
			-	apar07b
			-	apar12a
			-	apar13a
			-	apar12b
			-	apar13b
			-	aedb01b
			-	aedb04a
			-	aedb04b
			-	aedb04c
			-	aedb04d
			-	acrg13
			-	acmt01
			-	acmt02
			-	acmt03
			-	aabr02e
			-	acrg01m
			-	acrg07b
			-	adcd05k
			-	adcd08o
			-	adcd13d
			-	adcd16b
			-	adcd21o
			-	adsv03n
			-	adsv05ab
			-	adsv05bb
			-	adsv05cb
			-	adsv08ab
			-	adsv08bb
			-	adsv08cb
			-	adtc02h
			-	adtc04j
			-	adwr01q
			-	adwr05g
			-	aedb04f
			-	aemp01b
			-	aemp02g
			-	aemp16
			-	aemp32
			-	aemp48
			-	aemp54b
			-	afin01f
			-	afin01m
			-	afin02f
			-	afin02l
			-	afin03b
			-	ahea06
			-	alcd04b
			-	alcd11g
			-	apar09a
			-	apar09b
		-	aict01
		-	aict01nrw
		-	aict02
		-	aict03
		-	preload01
		-	alcd08a_g1
		-	alcd08b_g1
		-	alcd08c_g1
		-	alcd08d_g1
	-	the following value label containers were deleted:
		-	adbi10b_g1(_en)
		-	apar12aa_labelset(_en)
		-	apar12bb_labelset(_en)
		-	apar13aa_labelset(_en)
		-	apar13bb_labelset(_en)
		-	flag(_en)
		-	alcd08a_g1_labelset(_en)
		-	alcd08b_g1_labelset(_en)
		-	alcd08c_g1_labelset(_en)
		-	alcd08d_g1_labelset(_en)
-	documentation:
	-	structured metadata in the search portal at levels:
		-	questions (wave 1): images only displayed for one device
		-	variables (wave 1): variable deletions in data edition (see above) exist accordingly here
	-	attached metadata in the search portal:
		-	citation guideline (de/en) (wave 1) (instead now link to general citation guideline)
		-	coding lists


## [1.0.0] - 2020-06-30
### Added
-	data: wave 1 (de/en) for access ways "SUF: On-Site",  "SUF: Remote-Desktop", "SUF: Download" and "CUF: Download"
-	documentation:
	-	structured metadata in the search portal at levels:
		-	data package (de/en) (wave 1)
		-	surveys (de/en) (wave 1)
		-	instruments (de/en) (wave 1)
		-	questions (de/en) (wave 1)
		-	data sets (de/en) (wave 1)
		-	variables (de/en) (wave 1)
		-	concepts (de/en) (wave 1)
	-	attached metadata in the search portal:
		-	data and methods report (de) (wave 1)
		-	overview (de/en) (wave 1)
		-	variable questionnaire (de/en) (wave 1)
		-	coding list for countries (destatis), aggregated countries (NEPS), world regions (destatis) (de) (wave 1)
		-	coding list for destatis classification of subjects and DZHW subject groups (de) (wave 1)
		-	dataset report (de/en) (wave 1)
		-	citation guideline (de/en) (wave 1)