[ https://issues.apache.org/jira/browse/MSHARED-1326?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Michael Osipov closed MSHARED-1326. ----------------------------------- Resolution: Fixed Fixed with [65e9ed4606bfe902d2f340a78a1e376a34c11ad3|https://gitbox.apache.org/repos/asf?p=maven-reporting-api.git;a=commit;h=65e9ed4606bfe902d2f340a78a1e376a34c11ad3] for maven-reporting-api and with [cdf9631120a223b3b3cc740689c42729a50c63c5|https://gitbox.apache.org/repos/asf?p=maven-reporting-impl.git;a=commit;h=cdf9631120a223b3b3cc740689c42729a50c63c5] for maven-reporting-impl. > Improve (documentation on) MavenReport interface/AbstractMavenReport class > -------------------------------------------------------------------------- > > Key: MSHARED-1326 > URL: https://issues.apache.org/jira/browse/MSHARED-1326 > Project: Maven Shared Components > Issue Type: Task > Components: maven-reporting-api > Affects Versions: maven-reporting-impl-4.0.0-M11, > maven-reporting-api-4.0.0-M8 > Reporter: Michael Osipov > Assignee: Michael Osipov > Priority: Major > Fix For: maven-reporting-api-4.0.0-M9, > maven-reporting-impl-4.0.0-M12 > > > Based on a > [discussion|https://lists.apache.org/thread/6yxlvbhb7odfylfgjgzbvmvxg0vry20b] > with [~kriegaex], there are few conceptional or documentational issues with > the {{MavenReport}} interface: > * {{#getOutputName()}} does not clearly say that is actually an optional base > *path* and base name (base location) of the report item from a reporting > output directory. It needs at least a doc update and maybe even a rename to > {{#getOutputPath()}}/{{#getOutputPathLocation()}}? > * Both {{#setReportOutputDirectory(File outputDirectory)}} and > {{#getReportOutputDirectory()}} documentation imply that this directory > solely refers to this single report, but that is not correct. It refers to > root directory which contains all possibly generated reports. A shared > directory, not exclusive one. Consider your report generates in a subdir, > then these do *not* refer to it, but to its parent. -- This message was sent by Atlassian Jira (v8.20.10#820010)