Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add full documentation to the reference.conf file #300

Merged

Conversation

LukaszKontowski
Copy link
Contributor

@LukaszKontowski LukaszKontowski commented Oct 25, 2022

Closes #254
Closes #262
Closes #265

Adds full documentation to the reference.conf.
4 files from docs/ directory are deleted as their content (more or less modified) is now available in the reference.conf config comments.

One thing still missing is a description with example for usage of
org.virtuslab.ideprobe.dependencies.Plugin.FromSources which could be used in probe.intellij.plugins array. The reason is that for now this one is not clear to me and I did not manage to find a single example of usage for this type of Plugin. Moreover, it looks like FromSources usage is dedicated to users, who interact with ide-probe rather by direct code calls (and not by the .conf file), because it requires the user to have a custom implementation of DependencyBuilder and register it by using org.virtuslab.ideprobe.dependencies.DependencyProvider#registerBuilder...

If you have some suggestions / advice about it, that would be nice. Otherwise - I can create a separate issue for adding a proper comment for this one missing element.

@LukaszKontowski LukaszKontowski added the documentation Improvements or additions to documentation label Oct 25, 2022
@LukaszKontowski LukaszKontowski self-assigned this Oct 25, 2022
Comment on lines -9 to -10
// the `ext` field (file extension) must be an Option[String] and not a String for the ExistingIntelliJ usage
// inside the `org.virtuslab.ideprobe.dependencies.IntelliJVersionResolver` object
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

unrelated - deleted outdated invalid code comment

Copy link
Contributor

@PawelLipski PawelLipski left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✍🏻

Copy link
Contributor

@PawelLipski PawelLipski left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:benissimo:

Copy link
Contributor

@lukaszwawrzyk lukaszwawrzyk left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Aren't there references to file that you deleted? Perhaps now readme show direct users to this reference.conf file?

@LukaszKontowski
Copy link
Contributor Author

Aren't there references to file that you deleted? Perhaps now readme show direct users to this reference.conf file?

Thanks for suggestion - I will check that if there references to files that I deleted before merging. If they do exist - I will fix README in a separate PR soon.

@LukaszKontowski LukaszKontowski merged commit 5dfee1d into VirtusLab:master Oct 30, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
3 participants