# Release Notes for DZHW Panel Study of School Leavers 2018 (gsl2018)

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## [3.0.0] - 2026-10-30

### Added
- 	Data
  	- 	Data from waves 3a and 3b has been added, resulting in 11 datasets (dataset (2) remains unchanged):
    		(1) gsl2018_p_<...>:            	Student data from waves 1, 2, 3a, and 3b 
												integerated into a long format dataset 
												(4 observations per student).
    		(2) gsl2018_principals_x_<..:>: 	Data from principals of secondary schools
												(collected in wave 1).
    		(3) gsl2018_e_<...>:            	Spell data (also: episode data, event history data)
												on students' activities from 2014 to 2018 (monthly).
			(4) gsl2018_School_e_<...>:         Spell data (also: episode data, event history data) from episode module in wave 3a and 3b
												on students' school spells from 2018 to 2020.
			(5) gsl2018_VocTraining_e_<...>:    Spell data (also: episode data, event history data) from episode module in wave 3a and 3b
												on students' vocation training spells from 2018 to 2020.
			(6) gsl2018_Study_e_<...>:          Spell data (also: episode data, event history data) from episode module in wave 3a and 3b
												on students' study spells from 2018 to 2020.
			(7) gsl2018_Internship_e_<...>:     Spell data (also: episode data, event history data) from episode module in wave 3a and 3b
												on students' internship spells from 2018 to 2020.
			(8) gsl2018_FurtherEdu_e_<...>:     Spell data (also: episode data, event history data) from episode module in wave 3a and 3b
												on students' further education spells from 2018 to 2020.
			(9) gsl2018_Emp_e_<...>:            Spell data (also: episode data, event history data) from episode module in wave 3a and 3b
												on students' (dependent) employment spells from 2018 to 2020.
			(10) gsl2018_Unemp_e_<...>:         Spell data (also: episode data, event history data) from episode module in wave 3a and 3b
												on students' unemployment spells from 2018 to 2020.
			(11) gsl2018_SelfEmp_e_<...>:       Spell data (also: episode data, event history data) from episode module in wave 3a and 3b
												on students' self-employment spells from 2018 to 2020.
	- 	Variable wberufnovo (wave1) has been added to dataset (1).
	-	Several variables on respondents', parents', and grandparents' countries of birth have been added to dataset (1):
		- <...>_destatis (Coding according to Destatis BEV code for population statistics)
		- <...>_iso (Coding according to ISO-3166-1 coding list)
		- <...>_agg1 (Aggregation by sub-continent according to the Central Register of Foreign Nationals)
		- <...>_agg2 (Aggregation by continent)
	-	Variables `dist_ausbi`, `dist_hs`, `mindist1`, and `meandist3` on spatial distances 
		between school, vocational training, and higher education institutions have been added.

- 	Documentation
	- 	An English version of the Data and Methods Report has been added.
	-	Dataset Reports for new datasets (ds4-ds11) have been added (de/en). 
	- 	Filter flowcharts for waves 3a and 3b have been added (de).
	-	Variable and Question metadata for waves 3a and 3b have been added (de/en).

## Changed
- 	Data and Metadata
	-	Identifiers `pid`, `schulleitung_id`, and `schul_id` have been changed.
	- 	Some (numeric) missing values have been recoded.
	- 	Various variable and value labels have been edited both in German and English.
	-   Several variable names have been renamed/changed for consitency with established naming patterns:
		- `bewerb1_isei` and `bewerb2_isei` have been renamed to `bewerbb1_isei` and `bewerbb2_isei`
		- `bewerb1bf`, `bewerb1bhf`, and `bewerb1bof` have been renamed to `bewerb1_bf`, `bewerb1_bhf`, and `bewerb1_bof`
		- `bewerb2bf`, `bewerb2bhf`, and `bewerb2bof` have been renamed to `bewerb2_bf`, `bewerb2_bhf`, and `bewerb2_bof`
		- `ersber_<...>` have been renamed to `erstber_<...>`
		- `ersbert_<...>` have been renamed to `erstbert_<...>`

- 	Documentation
	- 	The Data and Methods Report has been updated (de).
	- 	The dataset overview has been updated (de/en).
	-	The dataset reports for existing datasets (ds1, ds2, ds3) have been updated (de/en). 
	- 	The variable questionnaire from wave 1 has been updated (de).
	- 	Variable questionnaires from wave 2 have been updated (de).

## Removed
-	Data
	-	Data from 29 students (observations) have been removed from the dataset(s).
	  	These students did not attain a higher education entrance certificate 
	  	and are not eligible for higher education or are otherwise no longer 
	  	considered part of the target population.
	-   Variables `amtbehind`, `bhindterm1`, `bhindterm2`, and `bhindgrad' (anonymized in previous version) 
		have been dropped from the dataset(s) due to GDPR.	
	-	Variables `<...>_g1` on respondents', parents', and grandparents' countries of birth 
		have been removed as project specific list on countries have been superseded by Destatis and ISO lists.

## [2.0.0] - 2025-11-20

### Added
- 	Data
  	- 	Data from wave 2 has been added, resulting in 3 datasets:
    		(1) gsl2018_p_<...>:            Student data from wave 1 and wave 2
                	                    	integerated into a long format dataset 
                        	            	(2 observations per student).
    		(2) gsl2018_principals_x_<..:>: Data from principals of secondary schools
                	                    	(collected in wave 1).
    		(3) gsl2018_e_<...>:            Spell data (also: episode data, event history data)
                	                    	on students' activities from 2014 to 2018 (monthly).
 	- 	Various variables on occupations of students and their parents have been added.
	  	The respective variables have the following names pattern:
	  	<...>beruf
	  	<...>_isco
	  	<...>_isei
	  	<...>_bf
	  	<...>_bhf
	  	<...>_bof
	-	Variable `gesund` on students self-assessed health has been added.

- 	Documentation
	- 	The Data and Methods Report has been updated (de).
	- 	The dataset overview has been updated (de/en).
	-	The dataset report has been updated (de/en). 
	- 	Variable questionnaires from wave 2 have been added (de).
	- 	Filer flowcharts for wave 2 have been added (de/en).
	-	Variable and Question metadata have been added (de/en).

## Changed
- 	Data and Metadata
	-	Identifiers `pid`, `schulleitung_id`, and `schul_id` have been changed.
	- 	Some (numeric) missing values have been recoded.
	- 	Various variable and value labels have been edited both in German and English. 

## Removed
-	Data
	-	Data from 204 students (observations) have been removed from the dataset.
	  	These students did not attain a higher education entrance certificate 
	  	and are not eligible for higher education or are otherwise no longer 
	  	considered part of the target population.

## [1.0.0] - 2022-12-19 (initial release date)

### Added
-	Data: wave 1 (de/en) (on-site SUF, remote-desktop SUF)
-	Documentation:
	-	Data and methods report (de)
	-	Overview (de/en)
	-	Data Use Instructions (de)
	-	Questionnaire (de)
	-	Variable Questionnaire (de/en)
	-	Question Flowchart (de/en)
	-	Dataset Report (de/en)

### Changed
-	Nothing, initial release

### Removed
-	Nothing, initial release

### Fixed
-	Nothing, initial release