anchor.diff:      |  #[code pip install -U spacy] to ensure that all installed models are
       |  can be used with the new version. The command is also useful to detect
       |  out-of-sync model links resulting from links created in different virtual
  -    |  environments. Prints a list of models, the installed versions, the latest
  -    |  compatible version (if out of date) and the commands for updating.
  +    |  environments. It will a list of models, the installed versions, the
  +    |  latest compatible version (if out of date) and the commands for updating.
  +
  ++aside("Automated validation")
  +    |  You can also use the #[code validate] command as part of your build
  +    |  process or test suite, to ensure all models are up to date before
  +    |  proceeding. If incompatible models or shortcut links are found, it will
  +    |  return #[code 1].
   
   +code(false, "bash", "$").
       python -m spacy validate
  
positive.code:     |  #[+a("/usage/models#usage") shortcut link] to load the model by name.
      |  Direct downloads don't perform any compatibility checks and require the
      |  model name to be specified with its version (e.g., #[code en_core_web_sm-1.2.0]).
  
  +code(false, "bash", "$").
      python -m spacy download [model] [--direct]
  
  +table(["Argument", "Type", "Description"])
      +row
          +cell #[code model]
          +cell positional
          +cell Model name or shortcut (#[code en], #[code de], #[code vectors]).
  
      +row
          +cell #[code --direct], #[code -d]
          +cell flag
          +cell Force direct download of exact model version.
  
      +row
          +cell #[code --help], #[code -h]
          +cell flag
          +cell Show help message and available arguments.
  
      +row("foot")
          +cell creates
          +cell directory, symlink
          +cell
              |  The installed model package in your #[code site-packages]
              |  directory and a shortcut link as a symlink in #[code spacy/data].
  
  +aside("Downloading best practices")
      |  The #[code download] command is mostly intended as a convenient,
  
negative.code:     |  from there. This will also allow you to add it as a versioned package
      |  dependency to your project.
  
  +code(false, "bash", "$").
      python -m spacy download [model] [--direct]
  
  +table(["Argument", "Type", "Description"])
      +row
          +cell #[code model]
          +cell positional
          +cell Model name or shortcut (#[code en], #[code de], #[code vectors]).
  
      +row
          +cell #[code --direct], #[code -d]
          +cell flag
          +cell Force direct download of exact model version.
  
      +row
          +cell #[code --help], #[code -h]
          +cell flag
          +cell Show help message and available arguments.
  
      +row("foot")
          +cell creates
          +cell directory, symlink
          +cell
              |  The installed model package in your #[code site-packages]
              |  directory and a shortcut link as a symlink in #[code spacy/data].
  
  +h(3, "link") Link
  
  p
  