Skip to content

Conversation

jmborr
Copy link
Member

@jmborr jmborr commented Nov 12, 2024

Description of work

Added a class diagram showing the main classes supporting the algorithm, and their relationships.

There is no associated issue. References EWM 8154

To test:

build the documentation (ninja docs-html) and verify the documentation for algorithm SaveISISReflectometryORSO has section Class Diagram showing the following picture:

This does not require release notes because is a minor addendum and only of interest only to developers.

Reviewer

Please comment on the points listed below (full description).
Your comments will be used as part of the gatekeeper process, so please comment clearly on what you have checked during your review. If changes are made to the PR during the review process then your final comment will be the most important for gatekeepers. In this comment you should make it clear why any earlier review is still valid, or confirm that all requested changes have been addressed.

Code Review

  • Is the code of an acceptable quality?
  • Does the code conform to the coding standards?
  • Are the unit tests small and test the class in isolation?
  • If there is GUI work does it follow the GUI standards?
  • If there are changes in the release notes then do they describe the changes appropriately?
  • Do the release notes conform to the release notes guide?

Functional Tests

  • Do changes function as described? Add comments below that describe the tests performed?
  • Do the changes handle unexpected situations, e.g. bad input?
  • Has the relevant (user and developer) documentation been added/updated?

Does everything look good? Mark the review as Approve. A member of @mantidproject/gatekeepers will take care of it.

Gatekeeper

If you need to request changes to a PR then please add a comment and set the review status to "Request changes". This will stop the PR from showing up in the list for other gatekeepers.

Introduced a UML class diagram to the documentation to illustrate the main classes supporting the SaveISISReflectometryORSO algorithm and their relationships. This should help users and developers to better understand the structure and dependencies involved.

Signed-off-by: Jose Borreguero <borreguero@gmail.com>
Changed the image width from 80% to 70% in the documentation for the SaveISISReflectometryORSO algorithm. This adjustment aims to improve layout and readability within the documentation.

Signed-off-by: Jose Borreguero <borreguero@gmail.com>
@jmborr jmborr added the Reflectometry Issues and pull requests related to reflectometry label Nov 12, 2024
@jmborr jmborr added this to the Release 6.12 milestone Nov 12, 2024
@jmborr jmborr requested a review from rbauststfc November 12, 2024 22:03
@jmborr jmborr self-assigned this Nov 12, 2024
Deleted the outdated class diagram image and its references from the documentation. Also, added a new section under `mantid.utils` for reflectometry utilities, detailing the `orso_helper` module and its functionality.

Signed-off-by: Jose Borreguero <borreguero@gmail.com>
@jmborr
Copy link
Member Author

jmborr commented Nov 13, 2024

class diagram moved to its own documentation page

@jmborr jmborr closed this Nov 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Reflectometry Issues and pull requests related to reflectometry
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant