Skip to content

Fix java doc warnings #1413

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

Open
wants to merge 7 commits into
base: dev
Choose a base branch
from
Open

Fix java doc warnings #1413

wants to merge 7 commits into from

Conversation

danielfeismann
Copy link
Member

resolves #494

merge first

@danielfeismann danielfeismann self-assigned this Aug 5, 2025
@danielfeismann danielfeismann added the documentation Improvements or additions to documentation label Aug 5, 2025
# Conflicts:
#	CHANGELOG.md
@danielfeismann danielfeismann added this to the Version 8.2 milestone Aug 7, 2025
@danielfeismann danielfeismann marked this pull request as ready for review August 8, 2025 08:36
Copy link
Member

@staudtMarius staudtMarius left a comment

Choose a reason for hiding this comment

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

I haven't look at every class, but I think a lot of the automatically generated javadoc needs polishing.

@@ -7,21 +7,37 @@

/**
* Exception that should be used whenever something invalid happens in a implementation of a {@link
* edu.ie3.datamodel.io.connectors.DataConnector}
* edu.ie3.datamodel.io.connectors.DataConnector}*
Copy link
Member

Choose a reason for hiding this comment

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

Why is there a * here?

/**
* Instantiates a new Duplicate entities exception.
*
* @param s the s
Copy link
Member

Choose a reason for hiding this comment

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

This should be renamed into something like the message. Maybe we should also rename the parameter.

@@ -7,17 +7,33 @@

/**
* Is thrown, when something went wrong during entity field mapping creation in a {@link
* edu.ie3.datamodel.io.processor.EntityProcessor}
* edu.ie3.datamodel.io.processor.EntityProcessor}*
Copy link
Member

Choose a reason for hiding this comment

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

Same as before.

/**
* Instantiates a new Topology exception.
*
* @param s the s
Copy link
Member

Choose a reason for hiding this comment

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

Should probably be renamed.

/**
* Instantiates a new Topology exception.
*
* @param s the s
Copy link
Member

Choose a reason for hiding this comment

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

Same as above.

Comment on lines +16 to 17
/** The type Hp input factory. */
public class HpInputFactory
Copy link
Member

Choose a reason for hiding this comment

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

Same as above.

Comment on lines +24 to 25
/** The type Load input factory. */
public class LoadInputFactory
Copy link
Member

Choose a reason for hiding this comment

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

Same as above.

@@ -45,6 +50,18 @@ protected T buildModel(
return buildModel(data, uuid, id, nodeA, nodeB, operator, operationTime);
}

/**
* Build model t.
Copy link
Member

Choose a reason for hiding this comment

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

The t should be replaced (maybe instance).

Comment on lines +14 to 15
/** The type Cylindrical storage input factory. */
public class CylindricalStorageInputFactory
Copy link
Member

Choose a reason for hiding this comment

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

Same as above.

Comment on lines +17 to 18
* @param <T> the type parameter
* @version 0.1
Copy link
Member

Choose a reason for hiding this comment

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

Same as above.

@danielfeismann
Copy link
Member Author

@staudtMarius I'm sorry, I should have written something about this beforehand. But I didn't expect someone to review this so quickly and in such depth. Most of it is generated automatically. There will certainly be improvements. There are now three options:

  1. to just take it as it is (while someone works around it and improves it),
  2. to give this to some HiWi,
  3. to solve it ourselfs.

Let's discuss this in office / sprint somewhen.

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
Development

Successfully merging this pull request may close these issues.

Fix JavaDoc warning
2 participants