[IFT] Add comments about help link names

GitOrigin-RevId: 745d8d57caf5877696376be258ff97137ab6374d

java/java-features-trainer/resources/messages/JavaLessonsBundle.properties

@@ -22,6 +22,7 @@ java.statement.completion.complete.for=Press {0} to complete the {1} statement.
 java.statement.completion.complete.if=Type {0} and press {1} to generate the statement.
 java.statement.completion.complete.condition=Add a condition inside the parentheses {0} and press {1} to jump into the {2} statement.
 java.statement.completion.complete.finish.body=Type a line of code: {0} and then press {1} to complete the statement and apply formatting.
+# Link name to the IDE help
 java.statement.completion.help.link=Statement completion
 
 java.rename.press.rename=Press {0} to rename field {1}.
@@ -61,6 +62,7 @@ java.inheritance.hierarchy.hide.method.hierarchy=Let''s (also) hide {0} too. Pre
 java.inheritance.hierarchy.open.class.hierarchy=To view the class hierarchy, press {0}.
 java.inheritance.hierarchy.last.note=<strong>Note:</strong> Actions {0} and {1} can be also applied to classes. \
   Actions {2} and {3} are rarely used, but you can always find them with {4} using the {5} filter.
+# Link name to the IDE help
 java.inheritance.hierarchy.help.link=Source code hierarchy
 
 java.find.occurrences.lesson.name=Next/previous occurrence
@@ -75,6 +77,7 @@ java.find.occurrences.find.next.in.editor=Locate the next occurrence with {0}.
 java.find.occurrences.find.previous.in.editor=And {0} to go backwards.
 java.find.occurrences.note.about.cyclic=<strong>Note:</strong> The search is cyclic. When you press {0} twice at the last occurrence, \
   the first occurrence will be selected. {1} is cyclic too.
+# Link name to the IDE help
 java.find.help.link=Search for a target within a file
 
 java.debug.workflow.hotswap.disabled.warning=The <strong>Hot Swap</strong> feature is disabled in the IDE settings. \

plugins/git-features-trainer/resources/messages/GitLessonsBundle.properties

@@ -32,6 +32,7 @@ git.quick.start.perform.commit=Type the commit message in the highlighted area.
   For example, it can be <code>Edit eyes color of puss in boots</code>. Then click {0}.
 git.quick.start.open.push.dialog=After performing a commit you can push it to the remote repository.
 git.quick.start.perform.push=Now click {0}. Your commit will be pushed to the repository created on your machine for tutorial purposes.
+# Link name to the IDE help
 git.quick.start.help.link=Set up a Git repository
 
 git.project.history.lesson.name=Project history
@@ -80,6 +81,7 @@ git.commit.amend.commit=Click the {0} button to edit the last commit.
 git.commit.select.top.commit.again=Select the top commit in the <strong>Git</strong> tool window again \
   to see information about the amended commit.
 git.commit.two.committed.files.explanation=Now you can see that the target commit contains two changed files.
+# Link name to the IDE help
 git.commit.help.link=Commit and push changes to Git repository
 
 git.feature.branch.lesson.name=Feature branch workflow
@@ -103,6 +105,7 @@ git.feature.branch.choose.force.push=You cannot just push the changes, because t
 git.feature.branch.confirm.force.push=Press {0} again to confirm the action.
 git.feature.branch.force.push.tip=<strong>Tip</strong>: do not use {0} if you are not the only user of the branch. \
   It can cause the loss of your colleagues'' commits.
+# Link name to the IDE help
 git.feature.branch.help.link=Manage Git branches
 
 git.interactive.rebase.lesson.name=Interactive rebase
@@ -127,6 +130,7 @@ git.interactive.rebase.apply.reword=By default, messages of all squashed commits
   Edit the message if you want and press {0} to apply rewording.
 git.interactive.rebase.start.rebasing=Finally, click {0}.
 git.interactive.rebase.congratulations=Congratulations! You have made the history of the project clean!
+# Link name to the IDE help
 git.interactive.rebase.help.link=Edit project history by performing interactive rebase
 
 git.changelists.shelf.lesson.name=Changelists and shelf
@@ -154,6 +158,7 @@ git.changelists.shelf.open.unshelve.dialog=When your changes are stored in {0},
 git.changelists.shelf.unshelve.changelist=Now you can edit the name of the changelist to put the unshelving changes or leave it as is. \
   Click {0} to apply the changes.
 git.changelists.shelf.congratulations=Congratulations! Now you know how to manage changelists and shelve your changes.
+# Link name to the IDE help
 git.changelists.shelf.help.link=Use Git to work on several features simultaneously
 
 git.annotate.lesson.name=Annotate with Git Blame
@@ -183,4 +188,5 @@ git.annotate.close.all.windows=And now close {0,choice,0#all opened windows|1#al
 git.annotate.close.annotations=Now you can close the annotations.
 git.annotate.close.by.shortcut=Press {0}.
 git.annotate.invoke.manually.2=Right-click the highlighted area and select the {0} option from the menu.
+# Link name to the IDE help
 git.annotate.help.link=Locate code author (Annotate with Git Blame)

plugins/ide-features-trainer/res/messages/LessonsBundle.properties

@@ -50,6 +50,7 @@ context.actions.invoke.general.intentions=<ide/> has a lot of intentions! Try to
 context.actions.apply.intention=Let''s apply the {0} intention.
 context.actions.refactorings.promotion=Note that a lot of useful refactorings are not available via {0}. \
  Go to the {1} module to learn how to invoke and use them.
+# Link name to the IDE help
 context.actions.help.intention.actions=Intention actions
 
 ## Editor basics module
@@ -76,6 +77,7 @@ collapse.try.collapse=Sometimes you need to collapse a piece of code for better
 collapse.hit.expand=To expand a code region, press {0}.
 collapse.all.collapse=If you want to collapse all regions in the file, press{0}.
 collapse.all.expand=Similarly, press {0} to expand all available regions.
+# Link name to the IDE help
 collapse.help.link=Expand or collapse code elements
 
 duplicate.and.delete.lines.lesson.name=Duplicate and delete lines
@@ -99,6 +101,7 @@ multiple.selections.select.next.symbol=Press {0} again to select the next occurr
 multiple.selections.deselect.symbol=Press {0} to deselect the last occurrence.
 multiple.selections.select.all=Press {0} to select all occurrences in the file.
 multiple.selections.replace=Type {0} to replace all occurrences of {1} with {0}.
+# Link name to the IDE help
 multiple.selections.help.multiple.carets=Multiple carets and selection ranges
 
 selection.lesson.name=Expand and shrink the code selection
@@ -106,6 +109,7 @@ selection.select.word=Place the caret before any word. Press {0} to move the car
 selection.extend.selection=Press {0} to extend the selection to the next code block.
 selection.extend.until.whole.file=Try to increase your selection with {0} until the whole file is selected.
 selection.shrink.selection={0} shrinks the selection. Try it.
+# Link name to the IDE help
 selection.help.select.code.constructs=Select code constructs
 
 new.selection.select.word=Press {0} to select the word under the caret.
@@ -127,6 +131,7 @@ surround.and.unwrap.invoke.surround=Press {0} to surround the selected code frag
 surround.and.unwrap.choose.surround.item=Choose {0} item.
 surround.and.unwrap.invoke.unwrap=Let''s return to the previous state with the unwrapping action by {0}.
 surround.and.unwrap.choose.unwrap.item=Choose the {0} item.
+# Link names to the IDE help
 surround.and.unwrap.help.surround.code.fragments=Surround code fragments
 surround.and.unwrap.help.unwrapping.and.removing.statements=Unwrapping and removing statements
 
@@ -140,6 +145,7 @@ basic.completion.start.typing=By default, <ide/> proposes completion for your co
 basic.completion.just.press.to.complete=Now just press {0} to complete this statement.
 basic.completion.activate.explicitly=To activate basic completion explicitly, press {0}.
 basic.completion.finish.explicit.completion=Select {0} and press {1}.
+# Link name to the IDE help
 basic.completion.help.code.completion=Basic completion
 
 completion.with.tab.lesson.name=Completion with tab
@@ -153,6 +159,7 @@ smart.completion.lesson.name=Type-matching completion
 postfix.completion.lesson.name=Postfix completion
 postfix.completion.intro=Postfix Completion helps you reduce backward caret jumps as you write code. \
   It lets you transform an already typed expression into another one based on the postfix you add, the type of expression, and its context.
+# Link name to the IDE help
 postfix.completion.help.link=Postfix code completion
 
 ## Refactoring module
@@ -163,6 +170,7 @@ refactorings.change.settings.warning.message=To complete this lesson, change ref
   Alternatively <callback id="{5}">click</callback> to change the setting.
 
 rename.lesson.name=Rename
+# Link name to the IDE help
 rename.help.link=Rename refactorings
 
 refactoring.menu.lesson.name=Refactoring menu
@@ -177,6 +185,7 @@ refactoring.menu.introduce.parameter=Suppose you are looking for a refactoring a
 refactoring.menu.start.refactoring=Press {0} to start the {1} refactoring. \
   <strong>Note</strong> that you can learn refactoring shortcuts from the refactoring menu.
 refactoring.menu.finish.refactoring=To complete refactoring, you need to choose some name or leave the default one and press {0}.
+# Link name to the IDE help
 refactoring.menu.help.link=Invoke refactoring
 
 ## Code Assistance module
@@ -196,6 +205,7 @@ local.history.restore.code=The right-hand pane shows a diff viewer that displays
 local.history.restore.code.balloon=Click to restore the code fragment
 local.history.close.window=Close the dialog to return to the changed code. Press {0}.
 local.history.congratulations=Great! You have restored your code fragment!
+# Link name to the IDE help
 local.history.help.link=Local History
 
 code.format.lesson.name=Code format
@@ -204,17 +214,20 @@ to reformat the selected code fragment with {0}.
 code.format.reformat.file=To reformat the whole file when no lines are selected, use {0}.
 code.format.show.reformat.file.dialog=Use {0} to show reformat settings.
 code.format.optimize.imports=Here you can configure reformat options. For example, switch {0} on and click {1}.
+# Link name to the IDE help
 code.format.help.link=Configuring code style
 
 parameter.info.lesson.name=Parameter info
 parameter.info.use.action=Press {0} to see the method''s signature.
 parameter.info.add.parameters=Use a width of {0} and a height of {1}.
+# Link name to the IDE help
 parameter.info.help.link=Parameter info
 
 quick.popups.lesson.name=Quick popups
 quick.popups.show.documentation=Press {0} to see the documentation for the symbol at the caret.
 quick.popups.press.escape=Press {0} to close the popup.
 quick.popups.show.implementation=Press {0} to see the definition of the symbol at the caret.
+# Link name to the IDE help
 quick.popups.help.link=Quick popups
 
 editor.coding.assistance.lesson.name=Editor coding assistance
@@ -226,6 +239,7 @@ editor.coding.assistance.show.warning.description=Also, you can see the warning
 editor.coding.assistance.fix.warning=The popup shows a refactoring action suggestion to fix this warning.
 editor.coding.assistance.highlight.usages=Another useful tool is the usages highlighting. \
   Press {0} to highlight all usages of the symbol at the caret within the file.
+# Link name to the IDE help
 editor.coding.assistance.help.link=Work with source code
 
 ## Navigation module
@@ -243,6 +257,7 @@ declaration.and.usages.right.click.tab=Right-click the tab title, {0}.
 declaration.and.usages.select.pin.item=Select {0}.
 declaration.and.usages.hide.view=When you have finished browsing usages, press {0} to hide the view.
 declaration.and.usages.open.find.view=Press {0} to open the {1} view again.
+# Link name to the IDE help
 declaration.and.usages.help.link=Go to declaration and its type
 
 file.structure.lesson.name=File structure
@@ -252,6 +267,7 @@ file.structure.request.prefixes=Suppose you want to find a method with {0} and {
   Type {2} (prefixes of the required words) to filter the file structure.
 file.structure.navigate=Only one item remains. Now press {0} to jump to the selected item.
 file.structure.toolwindow=<ide/> can also show you the file structure as a tool window. Open it with {0}.
+# Link name to the IDE help
 file.structure.help.link=View source file structure
 
 recent.files.lesson.name=Recent files and locations
@@ -271,6 +287,7 @@ recent.files.close.popup=Now the history of our recent files is cleaner. Click s
 recent.files.show.recent.locations=With another useful action, you can discover your code in the recently visited files. Press {0}
 recent.files.locations.search.typing=Here you can search by code fragments that you remember. Type {0}
 recent.files.locations.search.jump=Now select the highlighted fragment and press {0} to open the containing file.
+# Link name to the IDE help
 recent.files.locations.help.link=Find recent files
 
 search.everywhere.lesson.name=Search everywhere
@@ -307,6 +324,7 @@ find.in.files.select.directory=You can define the scope of search and replace. \
 find.in.files.press.replace.all=Press {0} to start refactoring.
 find.in.files.confirm.replace=Finally, press {0} to confirm refactoring.
 find.in.files.popup.closed.warning.message=Press {0} to open the {1} window again.
+# Link name to the IDE help
 find.in.files.help.link=Search and replace a target within a project
 
 extract.method.lesson.name=Extract method
@@ -315,6 +333,7 @@ extract.method.start.refactoring=Click {0} to start refactoring.
 extract.method.confirm.several.replaces=Cocktail sort has two swap places. The first fragment has just been extracted. \
   Click {0} to extract both of them.
 extract.method.second.fragment=Now you can confirm or reject the replacement of the second fragment.
+# Link name to the IDE help
 extract.method.help.link=Extract method
 
 extract.variable.lesson.name=Extract variable
@@ -322,6 +341,7 @@ extract.variable.start.refactoring=Press {0} to extract a local variable from th
 extract.variable.replace.all=This code block contains 3 occurrences of the selected expression. \
   Choose the second item on the list to replace all of them.
 extract.variable.choose.name=Choose a name for the new variable or leave it as it is. Press {0} to complete the refactoring.
+# Link name to the IDE help
 extract.variable.help.link=Extract/Introduce variable
 
 ## Run/Debug module
@@ -344,6 +364,7 @@ run.configuration.settings.description=This is a place for managing run/debug co
 run.configuration.tip.about.save.configuration.into.file=Tip: Sometimes you might want to save a configuration to its own file. \
   Such configurations will be easy to share between colleagues (usually, by using a version control system). \
   Now close the settings dialog to finish this lesson.
+# Link name to the IDE help
 run.configuration.help.link=Run/debug configurations
 
 debug.workflow.lesson.name=Debug workflow
@@ -375,10 +396,12 @@ debug.workflow.type.result=Type {0} into the {1} field, completion works.
 debug.workflow.evaluate.it=Press {0} or click {1}.
 debug.workflow.stop.debug=It is a correct answer! Let''s close the dialog and stop debugging with {0} or the {1} button.
 debug.workflow.resume=It seems there are no exceptions by now. Let''s continue execution with {0} or by clicking the {1} button.
+# Link name to the IDE help
 debug.workflow.help.link=Debug code
 
 onboarding.return.to.welcome.remark=\ and return to the Welcome screen
 
+# Link names to the IDE help
 help.search.everywhere=Searching Everywhere
 help.lines.of.code=Lines of code
 help.code.completion=Code completion

python/python-features-trainer/resources/messages/PythonLessonsBundle.properties

@@ -67,6 +67,7 @@ python.f.string.completion.type.prefix=<ide/> supports automatic f-string conver
 python.f.string.completion.invoke.manually=You can invoke completion manually with {0}.
 python.f.string.completion.complete.it=Complete the statement with {0}. Just press {1} to apply the first item.
 python.f.string.completion.result.message=You may see that a simple Python string was replaced by f-string after the completion.
+# Link name to the IDE help
 python.f.string.completion.help.link=F-string completion
 
 python.postfix.completion.type=Type {0} after the parenthesis to see the list of suggestions.
@@ -76,6 +77,7 @@ python.smart.completion.try.basic.completion=Try using Basic Completion by press
 python.smart.completion.use.smart.completion=Unfortunately, <ide/> has no direct information on the {0} type. \
  But sometimes, it can suggest completion by the context! Use {1} to invoke Smart Completion.
 python.smart.completion.finish.completion=Now just choose the {0} item to finish this lesson.
+# Link name to the IDE help
 python.smart.completion.help.link=Type-matching completion
 
 python.tab.completion.lesson.name=Tab completion
@@ -99,6 +101,7 @@ python.in.place.refactoring.set.default.value=Now you need to type the value tha
   You can choose {0} for this sample. Then press {1} to continue.
 python.in.place.refactoring.remark.about.application.scope=Note: In-place refactoring may be applied only in the \
   definition point whiles direct invocation of rename or change-signature refactorings may be called from both definition and usage.
+# Link names to the IDE help
 python.in.place.refactoring.help.rename.link=Rename code in place
 python.in.place.refactoring.help.signature.link=Change signature in place
 
@@ -115,6 +118,7 @@ python.quick.fix.refactoring.set.default.value=You may navigate through the fiel
   With the checkbox selected, <ide/> either inlines the default value to the other callers or sets it as the default value for the new parameter. \
   The Signature Preview will help you understand the difference. Now set the default value to 0.
 python.quick.fix.refactoring.finish.refactoring=Press {0} (or click {1}) to finish the refactoring.
+# Link name to the IDE help
 python.quick.fix.refactoring.help.link=Change signature
 
 python.rename.press.rename=Press {0} and rename the {1} field(e.g., to {2}).
@@ -128,7 +132,9 @@ python.editor.coding.assistance.fix.error=Let''s fix this error. Press {0} and s
 python.editor.coding.assistance.press.to.fix=Press {0} to remove the unexpected argument.
 
 python.run.configuration.lets.run=Let''s run our simple example with {0}.
+# Link name to the IDE help
 python.run.configuration.help.link=Code Running Assistance
 
 python.debug.workflow.rerun=Let''s rerun our program. Just click {0} again or use {1}.
+# Link name to the IDE help
 python.debug.workflow.help.link=Part 1. Debugging Python Code