You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This issue introduces a new documentation page, docs/local_dev_wsl.md, dedicated to guiding Windows developers through setting up Kolibri Studio using Windows Subsystem for Linux (WSL). The goal is to standardize the development environment for Windows and clearly indicate that developing directly on Windows (without WSL) is not recommended. Additionally, references to this new guide have been added to docs/local_dev_host.md , docs/host_services_setup.md and docs/local_dev_docker.md to ensure contributors are aware of the recommended setup.
Current behavior
Currently, there is no dedicated documentation page for setting up Kolibri Studio on Windows using WSL. The existing guides (docs/local_dev_host.md and docs/local_dev_docker.md) do not explicitly mention the WSL setup. This can lead to Windows developers attempting a native setup, which may result in inconsistent development environments and potential issues.
Value add
Improved Developer Experience: Provides clear, step-by-step instructions for Windows developers to set up a Linux-like development environment using WSL.
Standardization: Ensures that all contributors on Windows follow a consistent, recommended setup that aligns with the overall project development environment.
Reduced Support Overhead: By guiding developers to use WSL, we can help mitigate issues that arise from native Windows setups, leading to fewer support requests related to environment configuration.
Possible tradeoffs
Maintenance: Introducing an additional documentation page increases the documentation maintenance overhead.
Adoption Curve: Developers who are accustomed to a native Windows environment may need time to adapt to using WSL, although the long-term benefits are expected to outweigh this initial adjustment.
Add labels
Documentation Enhancement
The text was updated successfully, but these errors were encountered:
Desired behavior
This issue introduces a new documentation page, docs/local_dev_wsl.md, dedicated to guiding Windows developers through setting up Kolibri Studio using Windows Subsystem for Linux (WSL). The goal is to standardize the development environment for Windows and clearly indicate that developing directly on Windows (without WSL) is not recommended. Additionally, references to this new guide have been added to docs/local_dev_host.md , docs/host_services_setup.md and docs/local_dev_docker.md to ensure contributors are aware of the recommended setup.
Current behavior
Currently, there is no dedicated documentation page for setting up Kolibri Studio on Windows using WSL. The existing guides (docs/local_dev_host.md and docs/local_dev_docker.md) do not explicitly mention the WSL setup. This can lead to Windows developers attempting a native setup, which may result in inconsistent development environments and potential issues.
Value add
Improved Developer Experience: Provides clear, step-by-step instructions for Windows developers to set up a Linux-like development environment using WSL.
Standardization: Ensures that all contributors on Windows follow a consistent, recommended setup that aligns with the overall project development environment.
Reduced Support Overhead: By guiding developers to use WSL, we can help mitigate issues that arise from native Windows setups, leading to fewer support requests related to environment configuration.
Possible tradeoffs
Maintenance: Introducing an additional documentation page increases the documentation maintenance overhead.
Adoption Curve: Developers who are accustomed to a native Windows environment may need time to adapt to using WSL, although the long-term benefits are expected to outweigh this initial adjustment.
Add labels
The text was updated successfully, but these errors were encountered: