README Generator for VS Code Extension
Overview
Welcome to the README Generator for VS Code Extension! This tool helps you automatically generate detailed README.md
files for your projects using AI. It aims to save you time and effort, ensuring your project documentation is comprehensive, well-structured, and professional.
NOTE
Please be aware that the API used in this project has a rate limit. If the project does not work as expected, try to fork the project locally and then add your API key to avoid rate limit issues. This is the original repo of this project Generate README
Demo Video
Below is a demo video showcasing how to use the README Generator for VS Code.
https://github.com/user-attachments/assets/9acc3dbf-4e2e-422f-918a-ddd33c720c97
Features
-
Automated README Generation: Generate a
README.md
file with a single command.
-
Customizable Sections: Include specific sections such as Installation, Usage, Contributing, and more.
-
AI-Powered Content: Utilizes AI to create detailed and relevant content based on your project.
-
User-Friendly Interface: Simple and intuitive commands to generate and customize your README.
Installation
-
Install VS Code: Ensure you have Visual Studio Code installed on your computer.
-
Install the Extension: Search for
README Generator
in the VS Code Extensions Marketplace and install it.
-
Clone the Repository (for development):
git clone https://github.com/yourusername/readme-generator-vscode.git
cd readme-generator-vscode
-
Install Dependencies (for development):
npm install
-
Build the Extension (for development):
npm run build
Usage
-
Enter API Key: On first use, you will be prompted to enter your Gemini or OpenAI API key. This key will be stored securely.
-
Right-Click on a Folder: Navigate to the folder for which you want to generate a README. Right-click on the folder in the Explorer pane.
-
Select Generate README: From the context menu, select the
Generate README
option.
-
Automatic Generation: The extension will automatically generate a
README.md
file based on the content and structure of your project.
Sections
The generated README.md
includes the following sections:
-
Project Title: The name of your project.
-
Description: A brief description of what your project does.
-
Installation: Instructions on how to install and set up your project.
-
Usage: How to use your project.
-
Contributing: Guidelines for contributing to your project.
-
License: Information about the project's license.
Error Handling
Common Issues
-
Missing Dependencies: Ensure all dependencies are installed using
npm install
.
-
Build Errors: If you encounter build errors, run
npm run build
again and check for any missing or incompatible packages.
-
Permission Issues: Ensure you have the necessary permissions to write files in your project directory.
Troubleshooting
-
Command Not Found: If the
Generate README
command is not found, make sure the extension is properly installed and enabled in VS Code.
-
AI Content Issues: If the generated content is not accurate or relevant, you can manually edit the sections to better fit your project.
Contributing
We welcome contributions from the community! To contribute:
-
Fork the Repository: Click the "Fork" button at the top right of the repository page.
-
Clone Your Fork:
git clone https://github.com/yourusername/readme-generator-vscode.git
cd readme-generator-vscode
-
Create a Branch:
git checkout -b feature/your-feature-name
-
Make Your Changes: Implement your feature or bugfix.
-
Commit and Push:
git add .
git commit -m "Add your commit message here"
git push origin feature/your-feature-name
-
Create a Pull Request: Go to the repository on GitHub and create a pull request from your branch.
Extension
View here
License
This project is licensed under the MIT License. See the LICENSE file for more details.
Contact
For any questions or feedback, feel free to open an issue on GitHub or contact the project maintainer at Akash Singh.
Thank you for using the README Generator for VS Code Extension! We hope it helps you create great documentation for your projects.
Support
If you like this project, show your support & love!