Skip to content

Migrate concepts to api - phase 1#41086

Open
glass-ships wants to merge 1 commit intomainfrom
concepts-1
Open

Migrate concepts to api - phase 1#41086
glass-ships wants to merge 1 commit intomainfrom
concepts-1

Conversation

@glass-ships
Copy link
Contributor

Description of work

Another part of work on updating documentation.
Many concept pages contain info that would be better served being part of their respective API pages.

This PR is a first pass migrating content from concept pages that have a clear 1-to-1 match api page.

As part of this, we may want to configure some redirects so that links to the old concept page get forwarded to the API page instead.

To test:

Build user docs, check that the listed pages are no longer listed in concepts index, inspect modified API pages and see the new content above the existing reference.


Reviewer

Your comments will be used as part of the gatekeeper process. Comment clearly on what you have checked and tested during your review. Provide an audit trail for any changes requested.

As per the review guidelines:

  • Is the code of an acceptable quality? (Code standards/GUI standards)
  • Has a thorough functional test been performed? Do the changes handle unexpected input/situations?
  • Are appropriately scoped unit and/or system tests provided?
  • Do the release notes conform to the guidelines and describe the changes appropriately?
  • Has the relevant (user and developer) documentation been added/updated?
  • If the PR author isn’t in the mantid-developers or mantid-contributors teams, add a review comment rerun ci to authorize/rerun the CI

Gatekeeper

As per the gatekeeping guidelines:

  • Has a thorough first line review been conducted, including functional testing?
  • At a high-level, is the code quality sufficient?
  • Are the base, milestone and labels correct?

@github-actions github-actions bot added this to the Release 6.16 milestone Mar 19, 2026
@github-actions
Copy link
Contributor

Unit test results

2 861 tests   2 861 ✅  2h 3m 5s ⏱️
    1 suites      0 💤
    1 files        0 ❌

Results for commit 783d5bb.

@github-actions
Copy link
Contributor

System test results

808 tests   792 ✅  2h 4m 41s ⏱️
 48 suites   16 💤
 48 files      0 ❌

Results for commit 783d5bb.

@@ -1,3 +1,6 @@
.. _algm-BroadcastWorkspace:
Copy link
Member

Choose a reason for hiding this comment

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

I haven't seen these references at the top of any other algorithms. I don't think they belong

@@ -1,3 +1,4 @@
.. _MatrixWorkspace:
Copy link
Member

Choose a reason for hiding this comment

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

real question: would it be more clear to update what refers to the reference rather than adding one to the API page?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

i'm not sure i understand this question

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants