|= Getting Started

This repository provides workspace templates and configuration files to help you set up standardized development environments.

Basic Usage

  1. Discovery: Browse the workspaces/ directory to find a workflow that matches your tech stack (e.g., next.js, python, rust).

  2. Implementation:

    • Manual: Copy the relevant .vscode settings and boilerplate files to your project.

    • Multi-root: Optionally add template folders as roots in a local .code-workspace file; extension recommendations still apply per-folder from each root’s .vscode/extensions.json.

  3. Tooling: Use the Dev Center app to manage and sync these templates across your repositories.

Best Practices for Contributions

When contributing to this repository or using it as a base for your own templates:

Use Branches

For every new feature, bug fix, or contribution, create a new branch (e.g., git checkout -b my-new-template). This allows for multiple parallel contributions and a cleaner history.

Feature Isolation

Keep changes isolated to specific templates. If you are improving the Python template, ensure your changes don’t unintentionally affect the JavaScript templates unless it’s a deliberate global standard update.

Documentation

Ensure any new template or configuration is documented in its respective README.adoc and added to the Antora documentation site if applicable.