update ANEEL vignette for new year parameter

Update ANEEL vignette to reflect the new year argument for
energy_development_budget.

Document the valid 2017-2022 range, clarify that year can be
a single value or a vector, and fix ANEEL usage examples.

Author: geronimopulitini

vignettes/ANEEL.Rmd

@@ -16,13 +16,14 @@ knitr::opts_chunk$set(
 
 Loads data from the National Electrical Energy Agency (ANEEL), a Brazilian independent federal agency linked to the Ministry of Mines and Energy (MME). ANEEL works to provide favorable conditions for the Electrical Energy Market to develop with balance and for the benefit of society.
 
-As for now, there are three different datasets available for download: the Energy Development Budget and the Energy Generation.
+As for now, there are three different datasets available for download: Energy Development Budget, Energy Generation, and Energy Enterprises Distributed.
 
 #### Energy Development Budget
 
-The Energy Development Budget dataset showcases the Energy Development Account's (CDE) anual budget expenses. The CDE is designed to promote the Brazilian energy development and is managed by the Electrical Energy Commercialization Chamber (CCEE).
+The Energy Development Budget dataset showcases the Energy Development Account's (CDE) annual budget expenses. The CDE is designed to promote the Brazilian energy development and is managed by the Electrical Energy Commercialization Chamber (CCEE).
 
-The dataset makes available the year of the observation -- from 2013 to 2022 --, the type of expense, its value in R$ (Reais) and its share over the total amount of CDE budget expenses on the year\*.
+In the current implementation, data is available from 2017 to 2022 and must be downloaded by year. The year argument can be a single year or a vector of years.
+The dataset includes the type of expense, its value in R$ (Reais), and its share over the total amount of CDE budget expenses in each year.\*.
 
 \*Note that 'share_of_total' values sum to 1 for each year available.
 
@@ -55,6 +56,10 @@ The data is expressed in quantities and installed power in kW (kilowatt). The qu
       * `FALSE`: if you want the treated version of the data. 
 
   3. **language**: you can choose between Portuguese `("pt")` and English `("eng")`
+  4. **year**: only used for "energy_development_budget".
+It can be a single year or a vector of years from 2017:2022.
+This argument is required for "energy_development_budget" and can be
+omitted for the other datasets.
 
 ***
 
@@ -63,7 +68,22 @@ The data is expressed in quantities and installed power in kW (kilowatt). The qu
 ```{r eval=FALSE}
 # download treated data about energy generation
 clean_aneel <- load_aneel(
-  dataset = "energy generation",
+  dataset = "energy_generation",
   raw_data = FALSE
 )
+
+
+# download raw CDE data for one year
+budget_aneel_2019 <- load_aneel(
+  dataset = "energy_development_budget",
+  raw_data = TRUE,
+  year = 2019
+)
+
+# download raw CDE data for multiple years
+budget_aneel_multi <- load_aneel(
+  dataset = "energy_development_budget",
+  raw_data = TRUE,
+  year = c(2020, 2021)
+)
 ```