{"id":1683,"date":"2020-04-14T14:28:03","date_gmt":"2020-04-14T18:28:03","guid":{"rendered":"http:\/\/blog.wholetomato.com\/?p=1683"},"modified":"2023-11-21T07:25:52","modified_gmt":"2023-11-21T11:25:52","slug":"how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio","status":"publish","type":"post","link":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/","title":{"rendered":"How to add notes and navigation metadata directly in source code in Visual Studio"},"content":{"rendered":"\r\n<p>Comments in code might not only be some text floating around the functions, variables and classes, but they might contain some extra semantic information. With this improvement, you can navigate through projects much faster or even organize your knowledge. In this blog post, I&#8217;ll show you <strong>two ways<\/strong> on how to add extra metadata to comments in Visual Studio.<\/p>\r\n\r\n\r\n\r\n<h2 class=\"wp-block-heading\">Intro<\/h2>\r\n\r\n\r\n\r\n<p>Navigating through a large codebase might be a complicated task. It might be especially an issue when you have big projects (not to mention legacy systems) where logical parts are spread across many different files.<\/p>\r\n\r\n\r\n\r\n<p>In Visual Studio offers many tools that help with moving between headers, declarations, class hierarchies or all references of a given symbol. But what if you&#8217;d like to put a &#8220;todo&#8221; item? Or some extra note? Such supplementary information can not only help with quick tasks but also might build knowledge about a system.<\/p>\r\n\r\n\r\n\r\n<p>Here are the things you might want to use to help in Visual Studio<\/p>\r\n\r\n\r\n\r\n<ul class=\"wp-block-list\">\r\n<li>Task List<\/li>\r\n<li>Hashtags (as an extra plugin)<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n<p>Let&#8217;s start with the first one.<\/p>\r\n\r\n\r\n\r\n<h2 class=\"wp-block-heading\">Task Lists<\/h2>\r\n\r\n\r\n\r\n<p>Visual Studio contains a feature that enables us to add metadata directly in comments; It&#8217;s called <strong>Task List<\/strong>. Take a look at this piece of code from my legacy project:<\/p>\r\n\r\n\r\n\r\n<pre class=\"wp-block-preformatted\">class ShaderProgram\r\n{\r\nprivate:\r\n \u00a0 \u00a0GLuint mId;\r\n \u00a0 \u00a0std::vector&lt;Shader *&gt; mShaders; \/\/ refactor: \r\n                                    \/\/ convert to \r\n                                    \/\/ smart pointers!\r\npublic:\r\n \u00a0 \u00a0\/\/ todo: implement other special member functions!\r\n \u00a0 \u00a0ShaderProgram();\r\n \u00a0 \u00a0~ShaderProgram();<\/pre>\r\n\r\n\r\n\r\n<p>As you can see above, I put keywords like <code>refactor:<\/code> or <code>todo:<\/code> inside comments.<\/p>\r\n\r\n\r\n\r\n<p>Visual Studio builds an index of all comments with those special keywords and shows them in a separate window:<\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/04\/574d9-tasklistwindow.png?w=1140&#038;ssl=1\" alt=\"Visual Studio task list\" data-recalc-dims=\"1\" \/><\/figure>\r\n\r\n\r\n\r\n<p>This is a handy way of managing simple activities or just taking some small notes for the future. What&#8217;s more, the <code>refactor<\/code> keyword is a custom marker. Visual Studio adds flexibility to set it in the environment settings.<\/p>\r\n\r\n\r\n\r\n<p>Here&#8217;s the link to the documentation <a href=\"https:\/\/docs.microsoft.com\/en-us\/visualstudio\/ide\/using-the-task-list?view=vs-2019\">Use the Task List &#8211; Visual Studio | Microsoft Docs<\/a><\/p>\r\n\r\n\r\n\r\n<p>The task list is a nice improvement! The metadata lives inside comments so that other developers can pick up the same information. Still, you cannot easily transfer custom keywords, and the task window offers only basic support. For example, it doesn&#8217;t group things (like grouping all of the to-do lines).<\/p>\r\n\r\n\r\n\r\n<p>Is there anything better?<\/p>\r\n\r\n\r\n\r\n<h2 class=\"wp-block-heading\">Hashtags in Visual Assist<\/h2>\r\n\r\n\r\n\r\n<p>For several years I&#8217;ve been a happy user of Visual Assist &#8211; which is an excellent tool for enhancing various aspects of Visual Studio (have a look at my previous blog posts <a href=\"https:\/\/www.bfilipek.com\/2017\/05\/enhancing-visual-studio-with-visual.html\">here<\/a> or <a href=\"https:\/\/www.bfilipek.com\/2014\/11\/tools-to-understand-new-code.html\">here<\/a>). The tool also has a powerful feature called <strong>Hashtags<\/strong>. This is a combination of named bookmarks, task list and tags that you might know from social networks.<\/p>\r\n\r\n\r\n\r\n<p>Take a look at the example from my project with extra notes:<\/p>\r\n\r\n\r\n\r\n<pre class=\"wp-block-preformatted\">\/\/\/ creates and can build GLSL programs, #shadersSystem\r\nclass ShaderProgram\r\n{\r\nprivate:\r\n \u00a0 \u00a0GLuint mId;\r\n \u00a0 \u00a0std::vector&lt;Shader *&gt; mShaders; \/\/ #refactor\r\n                                    \/\/ convert to \r\n                                    \/\/ smart pointers \r\npublic:\r\n \u00a0 \u00a0\/\/ #refactor #ruleOfZero implement \r\n    \/\/ other special member functions!\r\n \u00a0 \u00a0ShaderProgram();\r\n \u00a0 \u00a0~ShaderProgram();<\/pre>\r\n\r\n\r\n\r\n<p>As you can see, this is just regular source code, but please notice those words proceeded with <code>#<\/code>. I&#8217;m using them to mark places that might be worth refactoring. For example, notes about refactoring:<\/p>\r\n\r\n\r\n\r\n<pre class=\"wp-block-preformatted\">std::vector&lt;Shader *&gt; mShaders; \/\/ #refactor \r\n                                \/\/ convert to smart pointers<\/pre>\r\n\r\n\r\n\r\n<p>Or another example:<\/p>\r\n\r\n\r\n\r\n<pre class=\"wp-block-preformatted\">\/\/\/ creates and can build GLSL programs, #shadersSystem<\/pre>\r\n\r\n\r\n\r\n<p>This time I&#8217;ve used <code>#shadersSystem<\/code> which groups elements that are crucial to the handling of OpenGL Shaders in my animation application.<\/p>\r\n\r\n\r\n\r\n<p>Below you can see all of the tags that are displayed in the <strong>VA Hashtags<\/strong> window. Similarly to Visual Studio, Visual Assist scans the source code and presents the indexed data.<\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/04\/d6deb-hashtagswindow.png?w=1140&#038;ssl=1\" alt=\"Hash Tags Window\" data-recalc-dims=\"1\" \/><\/figure>\r\n\r\n\r\n\r\n<p>In the picture above, you can see lots of different tags that I put throughout the code, for example:<\/p>\r\n\r\n\r\n\r\n<ul class=\"wp-block-list\">\r\n<li><code>#GlutCallbacks<\/code> &#8211; they refer to all callbacks that I passed to the GLUT framework (for my OpenGL Windows Application). With all of the tags grouped under one item, I can quickly move between those functions.<\/li>\r\n<li><code>#refactor<\/code>or <code>#modernize<\/code> &#8211; things to improve later.<\/li>\r\n<li>Other &#8220;notes&#8221; that refer to some subsystems like <code>#uiTweaks<\/code>, <code>#mainLoop<\/code> and others.<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n<p>The screenshot also shows a considerable difference compared to the task window. The hashtags are grouped, you can also filter them, or hide according to the project name, directory or even a filename.<\/p>\r\n\r\n\r\n\r\n<p>Tags are created &#8220;on the fly&#8221;, there&#8217;s no need to predefine them in some configuration window. You just type <code>#<\/code> and some extra text (you can configure the minimum length of a tag, it&#8217;s 3 by default).<\/p>\r\n\r\n\r\n\r\n<p>Tags are stored directly in the source code, so other developers can immediately see the same information (assuming they also use Visual Assist). Such functionality can be used to create even some simple task manager when you can assign a task by the name of a developer:<\/p>\r\n\r\n\r\n\r\n<pre class=\"wp-block-preformatted\">\/\/ #bartekToDo: please improve this code! don't use goto!<\/pre>\r\n\r\n\r\n\r\n<p>Here are some more things you can do with them<\/p>\r\n\r\n\r\n\r\n<ul class=\"wp-block-list\">\r\n<li>Cross-reference other tags. You can write <code>see:#otherTag<\/code> and <a href=\"https:\/\/www.wholetomato.com\/blog\/2020\/01\/23\/visual-assist-build-2358-is-available\/\" target=\"_blank\" rel=\"noopener\">Visual Assist<\/a> will build an extra list per tag that you can check.<\/li>\r\n<li>When you type <code>#<\/code> Visual Assist with autocomplete tags, so you can easily refer to existing hashtags<\/li>\r\n<li>When you hover over a hashtag in the hashtags window, you&#8217;ll see a tooltip with the source code that&#8217;s near the tag; this allows to get a better orientation without actually moving to the code.<\/li>\r\n<li>And many more!<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n<p>Here&#8217;s a great video that summarises the tool:<\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-embed-youtube wp-block-embed is-type-rich wp-embed-aspect-16-9 wp-has-aspect-ratio\">\r\n<div class=\"wp-block-embed__wrapper\">https:\/\/www.youtube.com\/watch?v=P7PliUeb2WY<\/div>\r\n<\/figure>\r\n\r\n\r\n\r\n<h2 class=\"wp-block-heading\">Summary<\/h2>\r\n\r\n\r\n\r\n<p>In this short blog post, I wanted to describe two tools that you can use to add extra information to comments. Having little <code>todo:<\/code> comments or additional notes can enhance your daily work and build a handy list of actions for the future, or even build up the knowledge about the system.<\/p>\r\n\r\n\r\n\r\n<p>Depending on your preferences, you can keep those extra notes permanently in your code or just temporarily and gradually move the knowledge and todo actions into external documentation or task manager.<\/p>\r\n\r\n\r\n\r\n<p>In my daily work, I prefer VA hashtags over regular bookmarks, as they are easier to use in most cases and shows that extra information and structure. You can read more about VA Hashtags on their documentation page: <a href=\"https:\/\/docs.wholetomato.com\/default.asp?W574\">Visual Assist Hashtags<\/a>.<\/p>\r\n\r\n\r\n\r\n<h3 class=\"wp-block-heading\">Back to you<\/h3>\r\n\r\n\r\n\r\n<ul class=\"wp-block-list\">\r\n<li>Do you use some extra tools that help you with code navigation?<\/li>\r\n<li>Do you use Visual Studio task window and task comments?<\/li>\r\n<li>Have you tried VA hashtags?<\/li>\r\n<\/ul>\r\n\r\n\r\n\r\n<p>This blog was brought to you by Bartlomiej Filipek, you can check out his C++ blog at <a href=\"https:\/\/www.bfilipek.com\">bfilipek.com<\/a><\/p>\r\n\r\n\r\n\r\n<figure class=\"wp-block-image size-large\"><a href=\"https:\/\/www.wholetomato.com\/downloads\"><img loading=\"lazy\" decoding=\"async\" width=\"1140\" height=\"285\" data-attachment-id=\"1717\" data-permalink=\"https:\/\/www.wholetomato.com\/blog\/blog-banner-1200x300-1\/\" data-orig-file=\"https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/05\/blog-banner-1200x300-1.png?fit=1200%2C300&amp;ssl=1\" data-orig-size=\"1200,300\" data-comments-opened=\"1\" data-image-meta=\"{&quot;aperture&quot;:&quot;0&quot;,&quot;credit&quot;:&quot;&quot;,&quot;camera&quot;:&quot;&quot;,&quot;caption&quot;:&quot;&quot;,&quot;created_timestamp&quot;:&quot;0&quot;,&quot;copyright&quot;:&quot;&quot;,&quot;focal_length&quot;:&quot;0&quot;,&quot;iso&quot;:&quot;0&quot;,&quot;shutter_speed&quot;:&quot;0&quot;,&quot;title&quot;:&quot;&quot;,&quot;orientation&quot;:&quot;0&quot;}\" data-image-title=\"blog-banner-1200&#215;300-1\" data-image-description=\"\" data-image-caption=\"\" data-medium-file=\"https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/05\/blog-banner-1200x300-1.png?fit=300%2C75&amp;ssl=1\" data-large-file=\"https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/05\/blog-banner-1200x300-1.png?fit=1024%2C256&amp;ssl=1\" class=\"wp-image-1717\" src=\"https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/05\/blog-banner-1200x300-1.png?resize=1140%2C285&#038;ssl=1\" alt=\"\" srcset=\"https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/05\/blog-banner-1200x300-1.png?w=1200&amp;ssl=1 1200w, https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/05\/blog-banner-1200x300-1.png?resize=300%2C75&amp;ssl=1 300w, https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/05\/blog-banner-1200x300-1.png?resize=1024%2C256&amp;ssl=1 1024w, https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/05\/blog-banner-1200x300-1.png?resize=768%2C192&amp;ssl=1 768w, https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/05\/blog-banner-1200x300-1.png?resize=360%2C90&amp;ssl=1 360w\" sizes=\"auto, (max-width: 1140px) 100vw, 1140px\" data-recalc-dims=\"1\" \/><\/a><\/figure>\r\n","protected":false},"excerpt":{"rendered":"<p>Comments in code might not only be some text floating around the functions, variables and classes, but they might contain some extra semantic information. With this improvement, you can navigate through projects much faster or&#8230;<\/p>\n","protected":false},"author":183830964,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_coblocks_attr":"","_coblocks_dimensions":"","_coblocks_responsive_height":"","_coblocks_accordion_ie_support":"","jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_newsletter_tier_id":0,"footnotes":"","jetpack_publicize_message":"","jetpack_is_tweetstorm":false,"jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","enabled":false}}},"categories":[672],"tags":[],"class_list":["post-1683","post","type-post","status-publish","format-standard","hentry","category-tips-and-tricks"],"jetpack_publicize_connections":[],"aioseo_notices":[],"jetpack_featured_media_url":"","jetpack_likes_enabled":true,"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/pfpLS4-r9","aioseo_head":"\n\t\t<!-- All in One SEO Pro 4.9.6.2 - aioseo.com -->\n\t<meta name=\"description\" content=\"Comments in code might not only be some text floating around the functions, variables and classes, but they might contain some extra semantic information. With this improvement, you can navigate through projects much faster or even organize your knowledge. In this blog post, I&#039;ll show you two ways on how to add extra metadata to\" \/>\n\t<meta name=\"robots\" content=\"max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n\t<meta name=\"author\" content=\"Bartlomiej Filipek\"\/>\n\t<meta name=\"google-site-verification\" content=\"DtHrwoEjg0KG_fbuPSp5j_wNIf-g5hSh4EH6tZBoCIw\" \/>\n\t<link rel=\"canonical\" href=\"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/\" \/>\n\t<meta name=\"generator\" content=\"All in One SEO Pro (AIOSEO) 4.9.6.2\" \/>\n\t\t<meta property=\"og:locale\" content=\"en_US\" \/>\n\t\t<meta property=\"og:site_name\" content=\"Tomato Soup - Visual Assist Team Blog\" \/>\n\t\t<meta property=\"og:type\" content=\"article\" \/>\n\t\t<meta property=\"og:title\" content=\"How to add notes and navigation metadata directly in source code in Visual Studio How to add notes and navigation metadata directly in source code in Visual Studio\" \/>\n\t\t<meta property=\"og:description\" content=\"Comments in code might not only be some text floating around the functions, variables and classes, but they might contain some extra semantic information. With this improvement, you can navigate through projects much faster or even organize your knowledge. In this blog post, I&#039;ll show you two ways on how to add extra metadata to\" \/>\n\t\t<meta property=\"og:url\" content=\"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/\" \/>\n\t\t<meta property=\"article:published_time\" content=\"2020-04-14T18:28:03+00:00\" \/>\n\t\t<meta property=\"article:modified_time\" content=\"2023-11-21T11:25:52+00:00\" \/>\n\t\t<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/wholetomatosoftware\" \/>\n\t\t<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n\t\t<meta name=\"twitter:site\" content=\"@visualassist\" \/>\n\t\t<meta name=\"twitter:title\" content=\"How to add notes and navigation metadata directly in source code in Visual Studio How to add notes and navigation metadata directly in source code in Visual Studio\" \/>\n\t\t<meta name=\"twitter:description\" content=\"Comments in code might not only be some text floating around the functions, variables and classes, but they might contain some extra semantic information. With this improvement, you can navigate through projects much faster or even organize your knowledge. In this blog post, I&#039;ll show you two ways on how to add extra metadata to\" \/>\n\t\t<meta name=\"twitter:creator\" content=\"@visualassist\" \/>\n\t\t<script type=\"application\/ld+json\" class=\"aioseo-schema\">\n\t\t\t{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\\\/#breadcrumblist\",\"itemListElement\":[{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog#listItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/category\\\/tips-and-tricks\\\/#listItem\",\"name\":\"Tips and Tricks\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/category\\\/tips-and-tricks\\\/#listItem\",\"position\":2,\"name\":\"Tips and Tricks\",\"item\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/category\\\/tips-and-tricks\\\/\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\\\/#listItem\",\"name\":\"How to add notes and navigation metadata directly in source code in Visual Studio\"},\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog#listItem\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\\\/#listItem\",\"position\":3,\"name\":\"How to add notes and navigation metadata directly in source code in Visual Studio\",\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/category\\\/tips-and-tricks\\\/#listItem\",\"name\":\"Tips and Tricks\"}}]},{\"@type\":\"FAQPage\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\\\/#aioseo-faq-page-64c3bed9332d6\",\"name\":\"How to add notes and navigation metadata directly in source code in Visual Studio\",\"description\":\"Comments in code might not only be some text floating around the functions, variables and classes, but they might contain some extra semantic information. With this improvement, you can navigate through projects much faster or even organize your knowledge. In this blog post, I'll show you two ways on how to add extra metadata to\",\"url\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\\\/\",\"mainEntity\":[{\"@type\":\"Question\",\"name\":\"How to add notes and navigation metadata directly in source code in Visual Studio?\",\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"Comments in code might not only be some text floating around the functions, variables, and classes, but they might contain some extra semantic information. With this improvement, you can navigate projects much faster or organize your knowledge. In this blog post, I\\u2019ll show you two ways to add extra metadata to comments in Visual Studio.\"}},{\"@type\":\"Question\",\"name\":\"What Do Visual Assist Offers?\",\"acceptedAnswer\":{\"@type\":\"Answer\",\"text\":\"In Visual Studio offers many tools that help with moving between headers, declarations, class hierarchies or all references of a given symbol. But what if you\\u2019d like to put a \\u201ctodo\\u201d item? Or some extra note? Such supplementary information can not only help with quick tasks but also might build knowledge about a system.\"}}],\"inLanguage\":\"en-US\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\\\/#breadcrumblist\"}},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/#organization\",\"name\":\"Tomato Soup\",\"description\":\"Visual Assist Team Blog\",\"url\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/\",\"email\":\"info@wholetomato.com\",\"numberOfEmployees\":{\"@type\":\"QuantitativeValue\",\"minValue\":0,\"maxValue\":100},\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https:\\\/\\\/i0.wp.com\\\/www.wholetomato.com\\\/blog\\\/wp-content\\\/uploads\\\/2020\\\/05\\\/wt-logo.jpg?fit=400%2C400&ssl=1\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\\\/#organizationLogo\",\"width\":400,\"height\":400},\"image\":{\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\\\/#organizationLogo\"},\"sameAs\":[\"https:\\\/\\\/www.facebook.com\\\/wholetomatosoftware\",\"https:\\\/\\\/twitter.com\\\/visualassist\",\"https:\\\/\\\/www.youtube.com\\\/c\\\/Wholetomatosoftware\",\"https:\\\/\\\/www.linkedin.com\\\/company\\\/whole-tomato-software\"]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/#website\",\"url\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/\",\"name\":\"Tomato Soup\",\"description\":\"Visual Assist Team Blog\",\"inLanguage\":\"en-US\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.wholetomato.com\\\/blog\\\/#organization\"}}]}\n\t\t<\/script>\n\t\t<!-- All in One SEO Pro -->\r\n\t\t<title>How to add notes and navigation metadata directly in source code in Visual Studio How to add notes and navigation metadata directly in source code in Visual Studio<\/title>\n\n","aioseo_head_json":{"title":"How to add notes and navigation metadata directly in source code in Visual Studio How to add notes and navigation metadata directly in source code in Visual Studio","description":"Comments in code might not only be some text floating around the functions, variables and classes, but they might contain some extra semantic information. With this improvement, you can navigate through projects much faster or even organize your knowledge. In this blog post, I'll show you two ways on how to add extra metadata to","canonical_url":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/","robots":"max-snippet:-1, max-image-preview:large, max-video-preview:-1","keywords":"","webmasterTools":{"google-site-verification":"DtHrwoEjg0KG_fbuPSp5j_wNIf-g5hSh4EH6tZBoCIw","miscellaneous":""},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"BreadcrumbList","@id":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/#breadcrumblist","itemListElement":[{"@type":"ListItem","@id":"https:\/\/www.wholetomato.com\/blog#listItem","position":1,"name":"Home","item":"https:\/\/www.wholetomato.com\/blog","nextItem":{"@type":"ListItem","@id":"https:\/\/www.wholetomato.com\/blog\/category\/tips-and-tricks\/#listItem","name":"Tips and Tricks"}},{"@type":"ListItem","@id":"https:\/\/www.wholetomato.com\/blog\/category\/tips-and-tricks\/#listItem","position":2,"name":"Tips and Tricks","item":"https:\/\/www.wholetomato.com\/blog\/category\/tips-and-tricks\/","nextItem":{"@type":"ListItem","@id":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/#listItem","name":"How to add notes and navigation metadata directly in source code in Visual Studio"},"previousItem":{"@type":"ListItem","@id":"https:\/\/www.wholetomato.com\/blog#listItem","name":"Home"}},{"@type":"ListItem","@id":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/#listItem","position":3,"name":"How to add notes and navigation metadata directly in source code in Visual Studio","previousItem":{"@type":"ListItem","@id":"https:\/\/www.wholetomato.com\/blog\/category\/tips-and-tricks\/#listItem","name":"Tips and Tricks"}}]},{"@type":"FAQPage","@id":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/#aioseo-faq-page-64c3bed9332d6","name":"How to add notes and navigation metadata directly in source code in Visual Studio","description":"Comments in code might not only be some text floating around the functions, variables and classes, but they might contain some extra semantic information. With this improvement, you can navigate through projects much faster or even organize your knowledge. In this blog post, I'll show you two ways on how to add extra metadata to","url":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/","mainEntity":[{"@type":"Question","name":"How to add notes and navigation metadata directly in source code in Visual Studio?","acceptedAnswer":{"@type":"Answer","text":"Comments in code might not only be some text floating around the functions, variables, and classes, but they might contain some extra semantic information. With this improvement, you can navigate projects much faster or organize your knowledge. In this blog post, I\u2019ll show you two ways to add extra metadata to comments in Visual Studio."}},{"@type":"Question","name":"What Do Visual Assist Offers?","acceptedAnswer":{"@type":"Answer","text":"In Visual Studio offers many tools that help with moving between headers, declarations, class hierarchies or all references of a given symbol. But what if you\u2019d like to put a \u201ctodo\u201d item? Or some extra note? Such supplementary information can not only help with quick tasks but also might build knowledge about a system."}},{"@type":"Question","name":"How to add notes and navigation metadata directly in source code in Visual Studio?","acceptedAnswer":{"@type":"Answer","text":"Comments in code might not only be some text floating around the functions, variables, and classes, but they might contain some extra semantic information. With this improvement, you can navigate projects much faster or organize your knowledge. In this blog post, I\u2019ll show you two ways to add extra metadata to comments in Visual Studio."}},{"@type":"Question","name":"What Do Visual Assist Offers?","acceptedAnswer":{"@type":"Answer","text":"In Visual Studio offers many tools that help with moving between headers, declarations, class hierarchies or all references of a given symbol. But what if you\u2019d like to put a \u201ctodo\u201d item? Or some extra note? Such supplementary information can not only help with quick tasks but also might build knowledge about a system."}}],"inLanguage":"en-US","breadcrumb":{"@id":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/#breadcrumblist"}},{"@type":"Organization","@id":"https:\/\/www.wholetomato.com\/blog\/#organization","name":"Tomato Soup","description":"Visual Assist Team Blog","url":"https:\/\/www.wholetomato.com\/blog\/","email":"info@wholetomato.com","numberOfEmployees":{"@type":"QuantitativeValue","minValue":0,"maxValue":100},"logo":{"@type":"ImageObject","url":"https:\/\/i0.wp.com\/www.wholetomato.com\/blog\/wp-content\/uploads\/2020\/05\/wt-logo.jpg?fit=400%2C400&ssl=1","@id":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/#organizationLogo","width":400,"height":400},"image":{"@id":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/#organizationLogo"},"sameAs":["https:\/\/www.facebook.com\/wholetomatosoftware","https:\/\/twitter.com\/visualassist","https:\/\/www.youtube.com\/c\/Wholetomatosoftware","https:\/\/www.linkedin.com\/company\/whole-tomato-software"]},{"@type":"WebSite","@id":"https:\/\/www.wholetomato.com\/blog\/#website","url":"https:\/\/www.wholetomato.com\/blog\/","name":"Tomato Soup","description":"Visual Assist Team Blog","inLanguage":"en-US","publisher":{"@id":"https:\/\/www.wholetomato.com\/blog\/#organization"}}]},"og:locale":"en_US","og:site_name":"Tomato Soup - Visual Assist Team Blog","og:type":"article","og:title":"How to add notes and navigation metadata directly in source code in Visual Studio How to add notes and navigation metadata directly in source code in Visual Studio","og:description":"Comments in code might not only be some text floating around the functions, variables and classes, but they might contain some extra semantic information. With this improvement, you can navigate through projects much faster or even organize your knowledge. In this blog post, I'll show you two ways on how to add extra metadata to","og:url":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/","article:published_time":"2020-04-14T18:28:03+00:00","article:modified_time":"2023-11-21T11:25:52+00:00","article:publisher":"https:\/\/www.facebook.com\/wholetomatosoftware","twitter:card":"summary_large_image","twitter:site":"@visualassist","twitter:title":"How to add notes and navigation metadata directly in source code in Visual Studio How to add notes and navigation metadata directly in source code in Visual Studio","twitter:description":"Comments in code might not only be some text floating around the functions, variables and classes, but they might contain some extra semantic information. With this improvement, you can navigate through projects much faster or even organize your knowledge. In this blog post, I'll show you two ways on how to add extra metadata to","twitter:creator":"@visualassist"},"aioseo_meta_data":{"post_id":"1683","title":"#post_title #post_title","description":null,"keywords":[],"keyphrases":{"focus":{"keyphrase":"","score":0,"analysis":{"keyphraseInTitle":{"score":0,"maxScore":9,"error":1}}},"additional":[]},"primary_term":null,"canonical_url":null,"og_title":null,"og_description":null,"og_object_type":"default","og_image_type":"default","og_image_url":null,"og_image_width":null,"og_image_height":null,"og_image_custom_url":null,"og_image_custom_fields":null,"og_video":"","og_custom_url":null,"og_article_section":null,"og_article_tags":[],"twitter_use_og":false,"twitter_card":"default","twitter_image_type":"default","twitter_image_url":null,"twitter_image_custom_url":null,"twitter_image_custom_fields":null,"twitter_title":null,"twitter_description":null,"schema":{"blockGraphs":[],"customGraphs":[],"default":{"data":{"Article":[],"Course":[],"Dataset":[],"FAQPage":[],"Movie":[],"Person":[],"Product":[],"ProductReview":[],"Car":[],"Recipe":[],"Service":[],"SoftwareApplication":[],"WebPage":[]},"graphName":"BlogPosting","isEnabled":false},"graphs":[{"id":"#aioseo-faq-page-64c3bed9332d6","slug":"faq-page","graphName":"FAQPage","label":"FAQ Page","properties":{"type":"FAQPage","name":"#post_title","description":"#post_excerpt","questions":[{"question":"How to add notes and navigation metadata directly in source code in Visual Studio?","answer":"Comments in code might not only be some text floating around the functions, variables, and classes, but they might contain some extra semantic information. With this improvement, you can navigate projects much faster or organize your knowledge. In this blog post, I\u2019ll show you two ways to add extra metadata to comments in Visual Studio."},{"question":"What Do Visual Assist Offers?","answer":"In Visual Studio offers many tools that help with moving between headers, declarations, class hierarchies or all references of a given symbol. But what if you\u2019d like to put a \u201ctodo\u201d item? Or some extra note? Such supplementary information can not only help with quick tasks but also might build knowledge about a system."}]}}]},"schema_type":"WebPage","schema_type_options":"{\"article\":{\"articleType\":\"BlogPosting\"},\"course\":{\"name\":\"\",\"description\":\"\",\"provider\":\"\"},\"faq\":{\"pages\":[\"{\\\"question\\\":\\\"How to add notes and navigation metadata directly in source code in Visual Studio?\\\",\\\"answer\\\":\\\"Comments in code might not only be some text floating around the functions, variables, and classes, but they might contain some extra semantic information. With this improvement, you can navigate projects much faster or organize your knowledge. In this blog post, I\\\\u2019ll show you two ways to add extra metadata to comments in Visual Studio.\\\"}\",\"{\\\"question\\\":\\\"What Do Visual Assist Offers?\\\",\\\"answer\\\":\\\"In Visual Studio offers many tools that help with moving between headers, declarations, class hierarchies or all references of a given symbol. But what if you\\\\u2019d like to put a \\\\u201ctodo\\\\u201d item? Or some extra note? Such supplementary information can not only help with quick tasks but also might build knowledge about a system.\\\"}\"]},\"product\":{\"reviews\":[]},\"recipe\":{\"ingredients\":[],\"instructions\":[],\"keywords\":[]},\"software\":{\"reviews\":[],\"operatingSystems\":[]},\"webPage\":{\"webPageType\":\"FAQPage\"}}","pillar_content":false,"robots_default":true,"robots_noindex":false,"robots_noarchive":false,"robots_nosnippet":false,"robots_nofollow":false,"robots_noimageindex":false,"robots_noodp":false,"robots_notranslate":false,"robots_max_snippet":"-1","robots_max_videopreview":"-1","robots_max_imagepreview":"large","priority":null,"frequency":"default","local_seo":null,"seo_analyzer_scan_date":null,"breadcrumb_settings":null,"limit_modified_date":false,"open_ai":"{\"title\":{\"suggestions\":[],\"usage\":0},\"description\":{\"suggestions\":[],\"usage\":0}}","ai":null,"created":"2022-02-02 22:51:09","updated":"2026-04-29 07:03:55"},"aioseo_breadcrumb":"<div class=\"aioseo-breadcrumbs\"><span class=\"aioseo-breadcrumb\">\n\t<a href=\"https:\/\/www.wholetomato.com\/blog\" title=\"Home\">Home<\/a>\n<\/span><span class=\"aioseo-breadcrumb-separator\">\u00bb<\/span><span class=\"aioseo-breadcrumb\">\n\t<a href=\"https:\/\/www.wholetomato.com\/blog\/category\/tips-and-tricks\/\" title=\"Tips and Tricks\">Tips and Tricks<\/a>\n<\/span><span class=\"aioseo-breadcrumb-separator\">\u00bb<\/span><span class=\"aioseo-breadcrumb\">\n\tHow to add notes and navigation metadata directly in source code in Visual Studio\n<\/span><\/div>","aioseo_breadcrumb_json":[{"label":"Home","link":"https:\/\/www.wholetomato.com\/blog"},{"label":"Tips and Tricks","link":"https:\/\/www.wholetomato.com\/blog\/category\/tips-and-tricks\/"},{"label":"How to add notes and navigation metadata directly in source code in Visual Studio","link":"https:\/\/www.wholetomato.com\/blog\/how-to-add-notes-and-navigation-metadata-directly-in-source-code-in-visual-studio\/"}],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/www.wholetomato.com\/blog\/wp-json\/wp\/v2\/posts\/1683","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wholetomato.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wholetomato.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wholetomato.com\/blog\/wp-json\/wp\/v2\/users\/183830964"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wholetomato.com\/blog\/wp-json\/wp\/v2\/comments?post=1683"}],"version-history":[{"count":10,"href":"https:\/\/www.wholetomato.com\/blog\/wp-json\/wp\/v2\/posts\/1683\/revisions"}],"predecessor-version":[{"id":3610,"href":"https:\/\/www.wholetomato.com\/blog\/wp-json\/wp\/v2\/posts\/1683\/revisions\/3610"}],"wp:attachment":[{"href":"https:\/\/www.wholetomato.com\/blog\/wp-json\/wp\/v2\/media?parent=1683"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wholetomato.com\/blog\/wp-json\/wp\/v2\/categories?post=1683"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wholetomato.com\/blog\/wp-json\/wp\/v2\/tags?post=1683"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}