Skip to content

Frontmatter dev#266

Merged
pelesh merged 39 commits intodevelopfrom
frontmatter-dev
Oct 7, 2025
Merged

Frontmatter dev#266
pelesh merged 39 commits intodevelopfrom
frontmatter-dev

Conversation

@pelesh
Copy link
Copy Markdown
Collaborator

@pelesh pelesh commented May 12, 2025

Description

The documentation at readthedocs.io fell behind Re::Solve development. It would be helpful to review the online documentation and update it as needed.

@nkoukpaizan @shakedregev
Closes #214.
Closes #298.

Proposed changes

This is draft PR to review outstanding actions on documentation updates.

These include:

  • Update user and developer documentation.
  • Ensure developer guidelines are in sync with clang-format configuration.
  • Create links at the landing page README to main topics in the documentation.
  • Add Re::Solve logos

Preview changes here.

Checklist

  • All tests pass. Code tested on
    • CPU backend
    • CUDA backend
    • HIP backend
  • Code compiles cleanly with flags -Wall -Wpedantic -Wconversion -Wextra.
  • The new code follows Re::Solve style guidelines.
  • There are unit tests for the new code.
  • The new code is documented.
  • The feature branch is rebased with respect to the target branch.

Further comments

@pelesh pelesh added this to the Release 0.99.2 milestone May 12, 2025
@pelesh pelesh requested review from kswirydo and maksud May 12, 2025 14:34
@pelesh pelesh self-assigned this May 12, 2025
@pelesh pelesh added documentation Improvements or additions to documentation enhancement New feature or request labels May 12, 2025
@pelesh pelesh force-pushed the frontmatter-dev branch from fe18d34 to dde06f8 Compare May 12, 2025 21:00
@pelesh pelesh force-pushed the frontmatter-dev branch from ec7f8cd to 0b7d635 Compare June 21, 2025 02:08
@pelesh pelesh force-pushed the frontmatter-dev branch from cc40cb9 to 9675b5c Compare June 28, 2025 04:48
@shakedregev shakedregev self-requested a review August 12, 2025 17:11
Comment thread README.md
Copy link
Copy Markdown
Collaborator

@shakedregev shakedregev left a comment

Choose a reason for hiding this comment

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

This looks good and it is far ahead of develop. Even if it's not perfect, I say we merge it.

@shakedregev shakedregev marked this pull request as ready for review August 21, 2025 19:08
pelesh and others added 21 commits October 7, 2025 15:17
Added details about implicit coding guidelines that were not specified.
Added suggested branching workflow.
Added PR reviewing and opening and issue guidelines.
Fixed typos
Restructured documentation sections 
Co-authored-by: pelesh <peless@ornl.gov>
Updated links in README to pint to readthedocs pages generated from `frontmatter-dev` branch. This needs to be reverted before merging.
---------

Co-authored-by: Adham Ibrahim <37982706+adham-ibrahim7@users.noreply.github.com>
Co-authored-by: Slaven Peles <peless@ornl.gov>
@pelesh pelesh merged commit 435e2c1 into develop Oct 7, 2025
@shakedregev shakedregev deleted the frontmatter-dev branch October 9, 2025 20:48
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 enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Improve sphinx documentation structure Update Contribution guidelines

2 participants