std-lib breaking changes

blog/2024-10-15-nushell_0_99_0.md

@@ -5,13 +5,15 @@ author_site: https://twitter.com/nu_shell
 author_image: https://www.nushell.sh/blog/images/nu_logo.png
 excerpt: Today, we're releasing version 0.99.0 of Nu. This release adds...
 ---
+
 <!-- TODO: complete the excerpt above -->
 
 # Nushell 0.99.0
 
 Nushell, or Nu for short, is a new shell that takes a modern, structured approach to your command line. It works seamlessly with the data from your filesystem, operating system, and a growing number of file formats to make it easy to build powerful command line pipelines.
 
 <!-- TODO: write this excerpt -->
+
 Today, we're releasing version 0.99.0 of Nu. This release adds...
 
 # Where to get it
@@ -21,6 +23,7 @@ Nu 0.99.0 is available as [pre-built binaries](https://github.com/nushell/nushel
 As part of this release, we also publish a set of optional plugins you can install and use with Nu. To install, use `cargo install nu_plugin_<plugin name>`.
 
 # Table of contents
+
 - [_Highlights and themes of this release_](#highlights-and-themes-of-this-release-toc)
 - [_Changes_](#changes-toc)
   - [_Additions_](#additions-toc)
@@ -48,6 +51,7 @@ As part of this release, we also publish a set of optional plugins you can insta
 -->
 
 # Highlights and themes of this release [[toc](#table-of-content)]
+
 <!-- NOTE: if you wanna write a section about a breaking change, when it's a very important one,
     please add the following snippet to have a "warning" banner :)
     > see [an example](https://www.nushell.sh/blog/2023-09-19-nushell_0_85_0.html#pythonesque-operators-removal)
@@ -68,8 +72,37 @@ As part of this release, we also publish a set of optional plugins you can insta
 
 ## Breaking changes [[toc](#table-of-content)]
 
+### Standard Library
+
+The internal storage location for the standard library, as well as how it is handled during Nushell start-up, has changed to improve launch times. While every effort has been made to ensure backward-compatibility, there may be some corner-cases in how other scripts and modules have imported `std` in the past.
+
+If you run into an issue, try the following import pattern. Replace `log` or `formats` with the module name you are using:
+
+```nu
+# If the module commands should be "prefixed", e.g., `log warning "Hello"`
+use std/log
+
+# When the module's command names should be available in the current namespace
+# E.g., `ls | to jsonl`
+use std/formats *
+```
+
+Refer to the [Standard Library](/book/standard_library.md) documentation for more information.
+
 ## Deprecations [[toc](#table-of-content)]
 
+### Standard Library - Directory Stack / Shells / dirs Module
+
+- [#13842](https://github.com/nushell/nushell/pull/13842): Starting with the next release, Nushell will no longer automatically load the `std/dirs` aliases at startup. In 0.99.0, using one of these aliases (`n`, `p`, `g`, `enter`, `dexit`, or `shells`) will result in a warning message.
+
+  To disable the warning message and prepare for 0.100.0, add the following to your startup configuration (typically `config.nu` or `env.nu`, etc.):
+
+  ```nu
+  use std/dirs shells-aliases *
+  ```
+
+  See the [Shells in Shells](/book/shells_in_shells.html) chapter of the Book for more options.
+
 ## Removals [[toc](#table-of-content)]
 
 ## Bug fixes and other changes [[toc](#table-of-content)]
@@ -107,15 +140,16 @@ As part of this release, we also publish a set of optional plugins you can insta
 
 Thanks to all the contributors below for helping us solve issues and improve documentation :pray:
 
-| author                               | title       | url                                                     |
-| ------------------------------------ | ----------- | ------------------------------------------------------- |
-| [@author](https://github.com/author) | ...         | [#12345](https://github.com/nushell/nushell/pull/12345) |
+| author                               | title | url                                                     |
+| ------------------------------------ | ----- | ------------------------------------------------------- |
+| [@author](https://github.com/author) | ...   | [#12345](https://github.com/nushell/nushell/pull/12345) |
 
 # Full changelog [[toc](#table-of-content)]
+
 <!-- TODO:
     paste the output of
     ```nu
     ./make_release/release-note/get-full-changelog
     ```
     here
--->
+-->