Notes on docs

Question

Notes on docs

Closed this issue a year ago · 9 comments

In https://duckdblabs.github.io/duckplyr/reference/as_duckplyr_df.html

for whatever reason

I know it's due to the experimental aspect but I wonder if a note could be added of what the reason could be.

There could furthermore be a mention of the environment variables DUCKPLYR_FALLBACK_INFO and DUCKPLYR_FORCE at that point.

Answer 1 · 2023-09-18T06:59:07.000Z

In the README

CAVEAT: factor columns are not supported yet

is there a list of not-supported-yet features that could be added to the docs?

Answer 2 · 2023-09-18T07:07:55.000Z

Consider putting the "Extensibility" section in a separate vignette rather than in the README.

Answer 3 · 2023-09-18T07:33:28.000Z

I'd expect the methods to have their own docs page, which might be the occasion to list caveats?

Answer 4 · 2023-09-18T07:35:24.000Z

In the docs of df_from_file why not add an example using the options argument?

Answer 5 · 2023-09-18T07:36:26.000Z

In https://duckdblabs.github.io/duckplyr/reference/config.html

DUCKPLYR_OUTPUT_ORDER: If TRUE, row output order is preserved. If FALSE,

the sentence is incomplete.

Answer 6 · 2023-09-18T07:38:22.000Z

In https://duckdblabs.github.io/duckplyr/reference/config.html

why use rlang for options and withr for environment variables instead of withr for both?

Answer 7 · 2023-09-18T07:39:09.000Z

In https://duckdblabs.github.io/duckplyr/reference/stats_show.html

The meaning of each line should be documented.

Answer 8 · 2023-09-19T16:31:43.000Z

Thanks! No list yet, this is a target moving too quickly.

Large-scale rearrangements will have to wait.

rlang::with_options() has the nicer interface.

Answer 9 · 2024-09-19T02:59:26.000Z

This old thread has been automatically locked. If you think you have found something related to this, please open a new issue and link to this old issue if necessary.