Skip to content
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

Add documentation #8

Merged
merged 86 commits into from
Dec 16, 2024
Merged

Add documentation #8

merged 86 commits into from
Dec 16, 2024

Conversation

RMeli
Copy link
Member

@RMeli RMeli commented May 22, 2024

  • Close Add documentation #7
  • Add GitHub Action to automatically deploy documentation on the gh-pages branch

Documentation Preview

The documentation is currently incomplete: only one function per algorithm is documented, plus the helper functions. It will be completed once the phrasing is agreed upon.

@RMeli RMeli added the documentation Improvements or additions to documentation label May 22, 2024
@RMeli RMeli self-assigned this May 22, 2024
.github/workflows/docs.yaml Outdated Show resolved Hide resolved
DLA-Future-Fortran.md Outdated Show resolved Hide resolved
@rasolca
Copy link
Collaborator

rasolca commented May 24, 2024

Preliminary questions:
Is the doc already available somewhere?
Any plan to keep the documentation of released versions?

@RMeli
Copy link
Member Author

RMeli commented May 24, 2024

Is the doc already available somewhere?

There is a preview from my fork: https://rmeli.github.io/DLA-Future-Fortran

Any plan to keep the documentation of released versions?

Not really... I'm open to suggestions.

DLA-Future-Fortran.md Outdated Show resolved Hide resolved
@RMeli RMeli marked this pull request as ready for review May 24, 2024 10:34
@RMeli RMeli marked this pull request as draft May 24, 2024 10:58
DLA-Future-Fortran.md Outdated Show resolved Hide resolved
src/dlaf_fortran.f90 Outdated Show resolved Hide resolved
@RMeli RMeli marked this pull request as ready for review December 3, 2024 16:35
@RMeli RMeli mentioned this pull request Dec 5, 2024
@RMeli
Copy link
Member Author

RMeli commented Dec 6, 2024

I merged #26 and added documentation for the new functions. I think it should be good to go for a final review.

Documentation Preview

Copy link
Collaborator

@msimberg msimberg left a comment

Choose a reason for hiding this comment

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

Will do a thorough review next week, but this one stood out too much, that I didn't want to forget to comment about it.

DLA-Future-Fortran.md Outdated Show resolved Hide resolved
Co-authored-by: Mikael Simberg <[email protected]>
@RMeli RMeli requested a review from msimberg December 6, 2024 10:45
.github/workflows/docs.yaml Outdated Show resolved Hide resolved
src/dlaf_fortran.f90 Show resolved Hide resolved
@rasolca
Copy link
Collaborator

rasolca commented Dec 13, 2024

Had a quick look. It looks good, however the Note boxes are a bit too invasive.

Will go through the doc carefully later.

Copy link
Collaborator

@rasolca rasolca left a comment

Choose a reason for hiding this comment

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

Some parameters terminate with . and some doesn't. It should be uniform.

@RMeli
Copy link
Member Author

RMeli commented Dec 13, 2024

@rasolca suggests to either make the note boxes less prominent, or simply remove the notes from a box.

@RMeli RMeli merged commit 7974277 into eth-cscs:main Dec 16, 2024
4 checks passed
@RMeli RMeli deleted the docs branch December 16, 2024 14:12
github-actions bot pushed a commit that referenced this pull request Dec 16, 2024
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.

Add documentation
4 participants