MitchellAcoustics/Soundscapy

Add from-scratch setup instructions for python novices

Ouverte

#158 ouverte le 15 mai 2026

Voir sur GitHubGuide contributeur
 (1 commentaire) (0 réaction) (1 personne assignée)Python (12 forks)auto 404
documentationgood first issue

Métriques du dépôt

Stars
 (58 étoiles)
Métriques de merge PR
 (Métriques PR en attente)

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

Guide contributeur

Direction de recherche
Examinez la documentation existante et identifiez l'emplacement approprié pour une nouvelle section sur la configuration Python. Ensuite, rédigez des instructions claires et étape par étape pour installer Python via Conda/Mamba, configurer un IDE, créer un environnement virtuel et exécuter un notebook Jupyter. Incluez des astuces de dépannage pour les problèmes courants.
Stack technique
python
Domaine
documentation
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
1
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Moins d'une heure
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Aucun
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
95