Comment Linker Extension

The Comment Linker extension for Visual Studio Code allows you to create clickable links within comments in Python files. It enhances code documentation by providing an easy way to reference other files or locations in your codebase.

Features

• Automatically detects and highlights links within comments in Python files.
• Supports both absolute and relative paths as links.
• Clicking on a link opens the corresponding file or location within Visual Studio Code.

Installation

1. Launch Visual Studio Code.
2. Go to the Extensions view (Ctrl+Shift+X).
3. Search for "Comment Linker" and click Install.
4. Reload Visual Studio Code to activate the extension.

Usage

1. Open a Python file in Visual Studio Code.

2. Write comments containing links using the following format:

   [link description](https://github.com/antunesdq/Comment-Linker/blob/HEAD/link target)
   

   For example:

   # Please see the [documentation](https://github.com/antunesdq/Comment-Linker/blob/HEAD/path/to/documentation.md) for more information.
   

3. Save the file. The links will be detected and highlighted automatically.

4. Hover over a link to view its description in a tooltip.

5. Click on a link to open the corresponding file or location within Visual Studio Code.

Configuration

The Comment Linker extension does not require any additional configuration. It automatically detects and highlights links within comments in Python files.

Known Issues

• Currently, the extension only supports Python files.
• Links are only recognized within comments and not within other parts of the code.

Feedback and Contributions

If you encounter any issues, have suggestions, or would like to contribute to the Comment Linker extension, please visit the GitHub repository. Contributions, bug reports, and feature requests are welcome.

Release Notes

Version 1.0.0

• Initial release of the Comment Linker extension.

License

This extension is released under the MIT License. See LICENSE for details.

Feel free to modify and expand upon this template to include more specific details about your extension, such as additional features, supported languages, or any customization options available.