fix: improve variable descriptions

Author: mtwente

docs/codebook.qmd

@@ -166,8 +166,8 @@ Since 2004, MPs from the Faroe Islands were members of `r sum(political_parties$
 #| label: tbl-parties
 #| tbl-cap: List of political parties from Greenland and the Faroe Islands with a MP in Folketinget since 2004.
 
-parties_gl <- subset(political_parties, Origin == "GL")[, !(names(political_parties) %in% "Origin")]
-parties_fo <- subset(political_parties, Origin == "FO")[, !(names(political_parties) %in% "Origin")]
+parties_gl <- subset(political_parties, Origin == "GL")[, !(names(political_parties) %in% c("Origin", "Colour"))]
+parties_fo <- subset(political_parties, Origin == "FO")[, !(names(political_parties) %in% c("Origin", "Colour"))]
 
 rownames(parties_gl) <- NULL
 rownames(parties_fo) <- NULL
@@ -297,6 +297,14 @@ Take care not to confuse `afstemningid` with [`ballot_results_ft$ballot_nr`](#ba
 head(northatlantic_votes_raw$afstemningid)
 ```
 
+#### northatlantic_votes_raw\$aktørid
+
+See [`northatlantic_votes$MP_id`](#northatlantic_votesmp_id). In the raw data, `aktørid` is stored as `r typeof(northatlantic_votes_raw$aktørid)` value.
+
+```{r}
+head(northatlantic_votes_raw$aktørid)
+```
+
 #### northatlantic_votes_raw\$opdateringsdato
 
 For all records kept in [the Folketing online database](https://oda.ft.dk), the time stamp of its last update is stored in `opdateringsdato`. All dates are stored as values of the type `r typeof(northatlantic_votes_raw$opdateringsdato)`. The time stamps are formatted as `%Y-%m-%dT%T`, with some values even at split second level.
@@ -585,31 +593,29 @@ head(ballot_topics$ft_process_id)
 
 #### ballot_topics\$ft_process_step {#ballot_topicsft_process_step}
 
-All legislative processes in Folketinget run their course through Folketinget in several steps which is described by `ft_process_step`. Process Steps are stored as values of the type `r typeof(ballot_topics$ft_process_step)` in Danish language..
-
-<!-- FIXME This variable corresponds to the [`sagstrinid`](#ballot_info_rawsagstrinid) variable and the `Sagstrin` resource in [the Folketing online database](https://oda.ft.dk). -->
+All legislative processes in Folketinget run their course through Folketinget in several steps which is described by `ft_process_step`. Process steps are stored as values of the type `r typeof(ballot_topics$ft_process_step)` in Danish language.
 
-`ft_process_id` is used to join `ballot_topics` to [`northatlantic_ft`](#northatlantic_ft) based on matching with[`ballot_results_ft$ft_process_id`](#ballot_results_ftft_process_id).
+This variable corresponds to the `titel` variable in the `Sagstrin` resource in [the Folketing online database](https://oda.ft.dk).
 
 ```{r}
-summary(ballot_topics$ft_process_step)
+head(ballot_topics$ft_process_step)
 ```
 
 #### ballot_topics\$ft_topic_id {#ballot_topicsft_topic_id}
 
-::: callout-note
-Description of new variable missing
-:::
+Each proposal that is being voted on in Folketinget is assigned an ID by [Folketingets åbne data service (ODA)](https://www.ft.dk/dokumenter/aabne_data) based on the proposal's topic. Each topic ID is thus a unique identifier for one topic relating to several ballots and debates etc. in Folketinget. This identifier is stored in `ft_topic_id`. Topic IDs are stored as values of the type `r typeof(ballot_topics$ft_topic_id)` as `r class(ballot_topics$ft_topic_id)` variable.
+
+This variable corresponds to the `id` variable in the `Sag` resource in [the Folketing online database](https://oda.ft.dk).
 
 ```{r}
 head(ballot_topics$ft_topic_id)
 ```
 
 #### ballot_topics\$ft_topic {#ballot_topicsft_topic}
 
-::: callout-note
-Description of new variable missing
-:::
+Each proposal that is being voted on in Folketinget has a description of the topic(s) that are mentioned in the proposal. This description is stored in `ft_topic`. Topic descriptions are stored as values of the type `r typeof(ballot_topics$ft_topic)` as `r class(ballot_topics$ft_topic)` variable.
+
+This variable corresponds to the `titel` variable in the `Sag` resource in [the Folketing online database](https://oda.ft.dk).
 
 ```{r}
 head(ballot_topics$ft_topic)
@@ -619,7 +625,7 @@ head(ballot_topics$ft_topic)
 
 ### northatlantic_ft {#northatlantic_ft}
 
-`northatlantic_ft` is the resulting product of the [targets pipeline](/_targets.R) and is provided as both `rds` file in `/data/processed` and `csv` file in `/data/processed/csv`. It contains data on voting records of the MPs specified in [`MP_names`](#mp_names), created by processing and joining [`ballot_results_ft`](#ballot_results_ft) and [`northatlantic_votes`](#northatlantic_votes). As per `r format(file.info(here("data", "processed", "northatlantic_ft.rds"))$mtime, "%B %Y")`, `northatlantic_ft` contains `r nrow(northatlantic_ft)` observations of `r ncol(northatlantic_ft)` variables.
+`northatlantic_ft` is the resulting product of the [targets pipeline](/_targets.R) and is provided as both `rds` file in `/data/processed` and `csv` file in `/data/processed/csv`. It contains data on voting records of the MPs specified in [`MP_names`](#mp_names), created by processing and joining [`ballot_results_ft`](#ballot_results_ft), [`northatlantic_votes`](#northatlantic_votes) and [`ballot_topics`](#ballot_topics). As per `r format(file.info(here("data", "processed", "northatlantic_ft.rds"))$mtime, "%B %Y")`, `northatlantic_ft` contains `r nrow(northatlantic_ft)` observations of `r ncol(northatlantic_ft)` variables.
 
 ```{r}
 str(northatlantic_ft)
@@ -669,9 +675,11 @@ str(northatlantic_ft$vote_type_id)
 
 #### northatlantic_ft\$vote_id
 
-::: callout-warning
-Description of new variable missing
-:::
+See [`northatlantic_votes$votes_id`](#northatlantic_votesvote_id).
+
+```{r}
+str(northatlantic_ft$vote_id)
+```
 
 #### northatlantic_ft\$ballot_pass
 
@@ -683,23 +691,23 @@ str(northatlantic_ft$ballot_pass)
 
 #### northatlantic_ft\$ft_process_step
 
-`ft_process_step` is created by using [`join_results()`](/src/targets/join_results.R) on `northatlantic_votes`, `ballot_results_ft`, `MP_names` and `ballot_topics`. See [`ballot_topics$ft_process_step`](#ballot_topicsft_process_step).
+See [`ballot_topics$ft_process_step`](#ballot_topicsft_process_step).
 
 ```{r}
 str(northatlantic_ft$ft_process_step)
 ```
 
 #### northatlantic_ft\$ft_topic_id
 
-`ft_topic_id` is created by using [`join_results()`](/src/targets/join_results.R) on `northatlantic_votes`, `ballot_results_ft`, `MP_names` and `ballot_topics`. See [`ballot_topics$ft_topic_id`](#ballot_topicsft_topic_id).
+See [`ballot_topics$ft_topic_id`](#ballot_topicsft_topic_id).
 
 ```{r}
 str(northatlantic_ft$ft_topic_id)
 ```
 
 #### northatlantic_ft\$ft_topic
 
-`ft_topic` is created by using [`join_results()`](/src/targets/join_results.R) on `northatlantic_votes`, `ballot_results_ft`, `MP_names` and `ballot_topics`. See [`ballot_topics$ft_topic`](#ballot_topicsft_topic).
+See [`ballot_topics$ft_topic`](#ballot_topicsft_topic).
 
 ```{r}
 str(northatlantic_ft$ft_topic)