diff --git a/docs/reference/yaml-options.md b/docs/reference/yaml-options.md
index de00c91cd..6be96dfdf 100644
--- a/docs/reference/yaml-options.md
+++ b/docs/reference/yaml-options.md
@@ -53,3 +53,20 @@ imports:
 !!! note "Added in 1.0"
 
     - relative file support in imports: `./mymodule.nix`
+
+### What if a package is out of date?
+    - Open [nixpkgs repo](https://github.com/NixOS/nixpkgs) and press `t` to search for your package.
+    -  Try to update/change the package using [the nixpkgs contributing guide](https://nixos.org/manual/nixpkgs/stable/#chap-quick-start), optionally contacting the maintainer for help if you get stuck.
+    - Make a PR and remember the branch name.
+    - Add it to your devenv.yaml like so
+    
+Using the nixpkgs input in form of 'github:$GH_USERNAME/nixpkgs/master', edit `devenv.yaml`:
+
+
+```yaml
+inputs:
+  nixpkgs:
+    url: 'github:$GH_USERNAME/nixpkgs/MYBRANCH'
+```
+
+