about summary refs log tree commit diff
path: root/doc/languages-frameworks/r.section.md
AgeCommit message (Collapse)AuthorFilesLines
2021-09-26doc: clarify location of rPackages overridesJustin Bedo1-1/+13
Detail the location of rPackage overrides and how broken builds should be addressed.
2021-09-24rPackages: mark packages as broken when generating package setsJustin Bedo1-8/+0
The current behaviour for generate-r-packages.R is to delete packages that have been remove upstream. This patch changes the behaviour to mark packages as broken rather than removing them. This has the advantage of never breaking expressions, which previously occured when a package with overrides in default.nix was deleted. As a result, the update procedure is simplified, allowing automated updates to the package tree to run, and additionally if a package is re-established upstream the previous overrides still exist.
2021-06-07doc: prepare for commonmarkJan Tojnar1-5/+5
We are still using Pandoc’s Markdown parser, which differs from CommonMark spec slightly. Notably: - Line breaks in lists behave differently. - Admonitions do not support the simpler syntax https://github.com/jgm/commonmark-hs/issues/75 - The auto_identifiers uses a different algorithm – I made the previous ones explicit. - Languages (classes) of code blocks cannot contain whitespace so we have to use “pycon” alias instead of Python “console” as GitHub’s linguist While at it, I also fixed the following issues: - ShellSesssion was used - Removed some pointless docbook tags.
2021-01-20doc: add function argument order convention (#110060)V1-5/+3
* doc: add function argument order convention Ordering by usage is the de facto ordering given to arguments. It's logical, and makes finding argument usage easier. Putting lib first is common in NixOS modules, so it's reasonable to mirror this in nixpkgs proper. Additionally, it's not a package as such, has zero dependencies, and can be found used anywhere in a derivation. * doc: clean up usage of lib
2021-01-02r-modules: update cran and bioc packagesTikhon Jelvis1-0/+6
The last snapshot was 4 months ago (2020-08-19). I also found that I needed newer definitions when I was trying to fix the R arrow package. This update required a couple of manual changes: 1. Removing a few deleted packages from default.nix 2. Renaming the "assert" package to "r_assert" in generate-r-packages.R because "assert" is a keyword in Nix
2021-01-01doc: explicit Markdown anchors for top-level headings; remove metadataRyan Mulligan1-2/+1
I used the existing anchors generated by Docbook, so the anchor part should be a no-op. This could be useful depending on the infrastructure we choose to use, and it is better to be explicit than rely on Docbook's id generating algorithms. I got rid of the metadata segments of the Markdown files, because they are outdated, inaccurate, and could make people less willing to change them without speaking with the author.
2019-10-20doc: organize chapters into parts, and reduce toc depthFrederik Rietdijk1-2/+2
Reorganize the chapters into parts and reduce the TOC depth to make the TOC useful again. The top-level TOC is very brief, but that is fine because every part will have its own TOC. Section titles of languages/frameworks are also simplified to just the name of the language/framework.
2018-03-25Move all nixpkgs doc files in to the doc directoryGraham Christensen1-0/+120
This makes a makefile-driven developer workflow nicer.