MitchellAcoustics/Soundscapy

Add from-scratch setup instructions for python novices

Aberta

#158 aberto em 15 de mai. de 2026

Ver no GitHubGuia do colaborador
 (1 comentário) (0 reação) (1 responsável)Python (12 forks)auto 404
documentationgood first issue

Métricas do repositório

Stars
 (58 estrelas)
Métricas de merge de PR
 (Métricas PR pendentes)

Description

What would you like to see?

Lots of our users are not familiar with setting up python or virtual environments, causing some particular issues for dealing with the R and python mixed environment issues.

We should add a page to the docs with from-scratch recommended python setup instructions. e.g.

  1. Install a conda environment manager (mamba)
  2. Install an IDE such as vs code
  3. Create a project folder
  4. Create a new conda environment for soundscapy, using mamba
  5. How to open a Jupyter notebook, etc. in the IDE and connect to the conda environment
  6. etc.

Why would this help?

No response

Extra details (optional)

No response

Guia do colaborador

Direção de pesquisa
Revise a documentação existente e identifique o local apropriado para uma nova seção sobre configuração do Python. Em seguida, escreva instruções claras e passo a passo para instalar o Python via Conda/Mamba, configurar uma IDE, criar um ambiente virtual e executar um notebook Jupyter. Inclua dicas de solução de problemas para problemas comuns.
Pilha de tecnologia
python
Domain
documentation
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
1
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
Menos de 1 hora
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
None
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
95