{"id":15984759,"url":"https://github.com/jaredreisinger/commentator","last_synced_at":"2025-03-18T00:31:38.829Z","repository":{"id":12378495,"uuid":"15030155","full_name":"JaredReisinger/Commentator","owner":"JaredReisinger","description":"Bringing a first-class comment experience to Visual Studio","archived":false,"fork":false,"pushed_at":"2015-06-04T07:47:37.000Z","size":4447,"stargazers_count":9,"open_issues_count":11,"forks_count":3,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-10-15T02:35:27.802Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JaredReisinger.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-08T19:54:06.000Z","updated_at":"2019-05-19T07:42:51.000Z","dependencies_parsed_at":"2022-09-23T06:13:09.123Z","dependency_job_id":null,"html_url":"https://github.com/JaredReisinger/Commentator","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaredReisinger%2FCommentator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaredReisinger%2FCommentator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaredReisinger%2FCommentator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JaredReisinger%2FCommentator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JaredReisinger","download_url":"https://codeload.github.com/JaredReisinger/Commentator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221703964,"owners_count":16866651,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-08T02:10:23.527Z","updated_at":"2024-10-27T16:24:57.058Z","avatar_url":"https://github.com/JaredReisinger.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Commentator\n\n_Bringing a first-class comment experience to Visual Studio._\n\n## Why another comment extension?\n\nThere are already several comment-formatting extensions for Visual Studio:\n[CommentsPlus](http://visualstudiogallery.msdn.microsoft.com/f76e86e3-03ca-4ac8-ba88-58c8f8d818f4),\n[redmuffin.MultiAdornment](http://visualstudiogallery.msdn.microsoft.com/03e958d5-66a5-4947-9d5e-334766cc5877),\n[JR Keywords](http://visualstudiogallery.msdn.microsoft.com/a99a9ef0-aba2-4948-a74e-abbc0d1a7daa),\n[DoxygenComments](http://visualstudiogallery.msdn.microsoft.com/11a30c1c-593b-4399-a702-f23a56dd8548),\n[VS10x Comments Extender](http://visualstudiogallery.msdn.microsoft.com/17c68951-7743-40bd-ad35-608706f54a92),\n[SharpComments](http://visualstudiogallery.msdn.microsoft.com/32b91d27-2a0f-4a4b-9ad3-caed8b4ced4b),\nand others, I'm sure.  Most of these provide some basic additional handling for\ncomments by using a leading character to provide different formatting.\n\nCommontator, on the other hand, seeks to make writing and updating comments a\nmuch more natural and useful experience.  What if the process of writing or\nediting comments felt more like using Word?  If adding a word or two in the\nmiddle of a comment didn't mean deciding between jaggedly uneven line lengths\nor manually reflowing to the next line (and the next, and the next).  What if\nyou didn't have to pay any attention to which column you were in, because what\nyou type automatically moves to the next line as needed?\n\nWelcome to Commentator.\n\n## Roadmap (roughly)\n\n * Auto-wrap comments as they are typed\n\n  * whitespace-separated words wrap on or before the line-length limit\n\n  * if the next line starts with a matching comment delimiter (same whitespace\n    before and after the \"//\") the word is injected into the beginning of the\n    line and that line is also wrapped\n\n * DocComment formatting\n\n  * more than just the DocComment tags, the entire comment block is formatted\n    to look like the MSDN-style documentation pages\n\n  * this _might_ include bringing in type/parameter/name information from the\n    related code\n\n  * support images in DocComments?  (and maybe elsewhere?)\n\n * also support prefix-based formatting (+, ++, !, ?, etc.?)\n\n * also support limited markdown formatting?\n\n * perhaps make multi-line (\"//\", \"//\" or \"/*...*/\") comments look like blocks\n   a la DocComments (above)?\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaredreisinger%2Fcommentator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaredreisinger%2Fcommentator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaredreisinger%2Fcommentator/lists"}