Find a place for reference documentation in Serving a Nix store via SSH · NixOS/nix#7978

2023-03-05T04:01:30.000Z

## Problem [Serving a Nix store via SSH](https://nixos.org/manual/nix/unstable/package-management/ssh-substituter.html) is a how-to guide that should be removed from the reference manual, see #7769. ## Proposal It's not entirely clear where the still interesting reference-style information and examples that don't appear anywhere else should go instead. There currently seems to be no place where the different URL syntaxes for substituters are documented. Options: - [`nix-copy-closure`](https://nixos.org/manual/nix/unstable/command-ref/nix-copy-closure.html) - [`substituters`](https://nixos.org/manual/nix/unstable/command-ref/conf-file.html#conf-substituters) Move the information, remove the page. > **Important** > add a [redirect on nixos.org](https://github.com/NixOS/nixos-homepage/blob/master/netlify.toml), otherwise existing links will break ## Priorities Add :+1: to [issues you find important](https://github.com/NixOS/nix/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc).

(1 comment) (0 reactions) (0 assignees)C++ (1.293 forks)batch import

documentationgood first issue

Métricas do repositório

Stars: (9.803 stars)
Métricas de merge de PR: (Mesclagem média 4d 12h) (86 fundiu PRs em 30d)

Description

Problem

Serving a Nix store via SSH is a how-to guide that should be removed from the reference manual, see #7769.

Proposal

It's not entirely clear where the still interesting reference-style information and examples that don't appear anywhere else should go instead. There currently seems to be no place where the different URL syntaxes for substituters are documented.

Options:

Move the information, remove the page.

Important add a redirect on nixos.org, otherwise existing links will break

Priorities

Add :+1: to issues you find important.

Guia do colaborador

Direção de pesquisa: Revise a issue vinculada #7769 para contexto. Examine as páginas de documentação de nix copy closure e substituters para determinar onde as informações de referência se encaixam melhor. Em seguida, mova o conteúdo da página SSH substituter para o local escolhido, remova a página original e adicione um redirecionamento no arquivo de configuração do Netlify (netlify.toml) no repositório da página inicial do NixOS.
Pilha de tecnologia: None
Domain: documentation
Tipo Issue: Documentação
Difficulty: 2
Tempo estimado: 1-3 horas
Status da atividade: Aguardando mantenedor
Clarity: Precisa de investigação
Prerequisites: Nix documentation structureMarkdownNetlify redirects
Simpatia para novatos: 40