df_generate_header_comments

Dart & Flutter Packages by dev-cetera.com & contributors.

This tool automatically adds standardized comment headers to your source files, enhancing protection, consistency, and authenticity across your codebase.

How to Use

With Visual Studio Code

Install the extension here: https://marketplace.visualstudio.com/items?itemName=Dev-Cetera.dev-cetera-df-support-commands

Create a template file in your project's directory and call it header_template.md:

```dart
// The use of this source code is governed by the LICENSE file located in this
// project's root directory.
```

Back up your source code!
Right-click on any folder in your project and select 🔹 Generate Header Comments.
Alternatively, right-click a folder and select "Open in Integrated Terminal" then run --headers -t path/to/header_template.md in the terminal.
This will modify source files in the folder and add the header comments.

Without Visual Studio Code

Install this tool by running: dart pub global activate df_generate_header_comments.
Back up your source code!

Create a template file and call it something like header_template.md:

```dart
// The use of this source code is governed by the LICENSE file located in this
// project's root directory.
```

Open a terminal at a desired folder then run --headers -t path/to/header_template.md in the terminal. This will modify source files in the folder and add the header comments.

☝️ Please refer to the API reference for more information.

💬 Contributing and Discussions

This is an open-source project, and we warmly welcome contributions from everyone, regardless of experience level. Whether you're a seasoned developer or just starting out, contributing to this project is a fantastic way to learn, share your knowledge, and make a meaningful impact on the community.

☝️ Ways you can contribute

Buy me a coffee: If you'd like to support the project financially, consider buying me a coffee. Your support helps cover the costs of development and keeps the project growing.
Find us on Discord: Feel free to ask questions and engage with the community here: https://discord.gg/gEQ8y2nfyX.
Share your ideas: Every perspective matters, and your ideas can spark innovation.
Help others: Engage with other users by offering advice, solutions, or troubleshooting assistance.
Report bugs: Help us identify and fix issues to make the project more robust.
Suggest improvements or new features: Your ideas can help shape the future of the project.
Help clarify documentation: Good documentation is key to accessibility. You can make it easier for others to get started by improving or expanding our documentation.
Write articles: Share your knowledge by writing tutorials, guides, or blog posts about your experiences with the project. It's a great way to contribute and help others learn.

No matter how you choose to contribute, your involvement is greatly appreciated and valued!

☕ We drink a lot of coffee...

If you're enjoying this package and find it valuable, consider showing your appreciation with a small donation. Every bit helps in supporting future development. You can donate here: https://www.buymeacoffee.com/dev_cetera

🧑‍⚖️ License

This project is released under the MIT License. See LICENSE for more information.