mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2025-08-29 15:06:26 +02:00
Refactored pc roles and added README.md's with help of ChatGPT. See https://chat.openai.com/share/df22ba6a-76d0-47c2-a8c7-daec3f42b4e5
This commit is contained in:
34
roles/pc-developer-tools/README.md
Normal file
34
roles/pc-developer-tools/README.md
Normal file
@@ -0,0 +1,34 @@
|
||||
# PC-Developer-Tools Role
|
||||
|
||||
## Overview
|
||||
This README document is for the `pc-developer-tools` role within the `computer-playbook` repository. The role is designed to streamline the setup of essential development tools on personal computers, particularly for software development environments.
|
||||
|
||||
## Role Contents
|
||||
The `main.yml` file under the `pc-developer-tools` role includes tasks focused on the installation of key development tools:
|
||||
|
||||
1. **Install Base Developer Tools**:
|
||||
- This task uses the `community.general.pacman` module to install:
|
||||
- `code`: Visual Studio Code (VS Code), a powerful and popular open-source code editor that is highly customizable and supports a wide range of programming languages.
|
||||
|
||||
## Dependencies
|
||||
This role relies on:
|
||||
- **pc-administrator-tools**: Ensures that core administrative tools are installed, which can be essential for various development tasks.
|
||||
|
||||
## Purpose and Usage
|
||||
The `pc-developer-tools` role is tailored for developers who need a quick and efficient setup of a development environment on their personal computer. It is particularly useful for programmers, software engineers, and anyone involved in software development who prefers a streamlined and efficient workflow.
|
||||
|
||||
## Prerequisites
|
||||
- **Ansible**: Required to run this role.
|
||||
- **Arch Linux-based System**: The role is designed with the `pacman` package manager in mind, thus it is best suited for Arch Linux or similar distributions.
|
||||
|
||||
## Running the Role
|
||||
To utilize this role:
|
||||
1. Clone the `computer-playbook` repository.
|
||||
2. Navigate to the `roles/pc-developer-tools` directory.
|
||||
3. Run the role using Ansible, making sure you have the necessary privileges for package installation.
|
||||
|
||||
## Customization
|
||||
Users can customize this role by adding more development tools or editors according to their specific needs in the `main.yml` file.
|
||||
|
||||
## Support and Contributions
|
||||
For support, feedback, or contributions (such as adding more developer tools or enhancing the existing setup), please open an issue or submit a pull request in the `computer-playbook` repository. Contributions that improve the development environment setup are highly welcomed.
|
2
roles/pc-developer-tools/meta/main.yml
Normal file
2
roles/pc-developer-tools/meta/main.yml
Normal file
@@ -0,0 +1,2 @@
|
||||
dependencies:
|
||||
- pc-administrator-tools
|
5
roles/pc-developer-tools/tasks/main.yml
Normal file
5
roles/pc-developer-tools/tasks/main.yml
Normal file
@@ -0,0 +1,5 @@
|
||||
- name: install base developer tools
|
||||
community.general.pacman:
|
||||
name:
|
||||
- code
|
||||
state: present
|
Reference in New Issue
Block a user