Use Markdown formatting in docs

[etiennebacher]

I just realized that markdown syntax is used in (part of) the docs but wasn't properly rendered (see for instance the * not rendered as bullet points in ?languages_supported). This PR fixes that and one roxygen2 warning about the deprecated usage of @docType package.

---

Edit: used this occasion to also update the CI workflow

[etiennebacher]

@vincentarelbundock wdi.dl and wdi.query have the following:

#' @export
#' @keywords internal
#' @noRd

which generates a warning Undocumented code objects. Should they be internal or exported? I guess they should be exported otherwise that would be a breaking change. If so, they could just inherit the docs from other functions but I'd like you to confirm before I spend time on this.

[vincentarelbundock]

yeah, IIRC, these were never intended to be exported. So it's a breaking change but only because of a docs issue.

I'm happy with any solution you want to implmeent

[etiennebacher]

I removed them since it's the fastest to do and they have "internal function" in the title anyway

[etiennebacher]

Do you have any idea why this fails?

library(WDI)
cache = WDIcache()
old <- WDIsearch('gdp.*capita.*constant')
new <- WDIsearch("gdp.*capita.*constant", cache = cache)

waldo::compare(old, new)
#> `attr(old, 'row.names')`: 717 11431 11433 11435 11436
#> `attr(new, 'row.names')`: 692 12372 12374 12376 12377
#> 
#> old vs new
#>                                                            name
#>   old[1, ] GDP per capita, PPP (constant 2011 international $) 
#>   old[2, ] GDP per capita (constant 2015 US$)                  
#>   old[3, ] GDP per capita (constant LCU)                       
#> - old[4, ] GDP per capita, PPP (constant 2017 international $) 
#> + new[4, ] GDP per capita, PPP (constant 2021 international $) 
#>   old[5, ] GDP per capita, PPP (constant 1987 international $) 
#> 
#> old$name vs new$name
#>   "GDP per capita, PPP (constant 2011 international $) "
#>   "GDP per capita (constant 2015 US$)"
#>   "GDP per capita (constant LCU)"
#> - "GDP per capita, PPP (constant 2017 international $)"
#> + "GDP per capita, PPP (constant 2021 international $)"
#>   "GDP per capita, PPP (constant 1987 international $)"

My guess is that we should update data/WDI_data.RData but I don't know how. (Sorry, I thought this would be a routine PR)

[vincentarelbundock]

Yep, I think that's the problem.

I pushed a new search cache and added a note to the readme to indicate how to do it.

[vincentarelbundock]

Thanks!