Skip to content

chore: Add template for algorithms documentation#834

Merged
starovoid merged 3 commits intomasterfrom
algodocs-deflts
Jun 21, 2025
Merged

chore: Add template for algorithms documentation#834
starovoid merged 3 commits intomasterfrom
algodocs-deflts

Conversation

@starovoid
Copy link
Collaborator

This PR adds a file describing the approach to documenting algorithms.

In the future, this file will be referenced by CONTRIBUTING.md and any other instructions for adding new algorithms.

@starovoid starovoid added this to the 0.8.3 milestone Jun 20, 2025
@starovoid starovoid added the A-readme Area: Documentation that isn't part of any crate such as README.md or CONTRIBUTING.rst label Jun 20, 2025
@RaoulLuque
Copy link
Member

Looks great, thanks 🌞

@starovoid starovoid added this pull request to the merge queue Jun 21, 2025
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Jun 21, 2025
github-merge-queue bot pushed a commit that referenced this pull request Jun 21, 2025
This PR removes the \[Generic\] tag from the docstrings of algorithms as
discussed
[here](#834 (comment)).
@RaoulLuque RaoulLuque added this pull request to the merge queue Jun 21, 2025
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Jun 21, 2025
@RaoulLuque
Copy link
Member

Not sure what's going on with the rust stable job but I'm re-running it 🤔

@starovoid
Copy link
Collaborator Author

Not sure what's going on with the rust stable job but I'm re-running it 🤔

I recently had a nightly test fail, so there must be a system-related reason.

@RaoulLuque
Copy link
Member

system-related as in GitHub CI runners or something in the crate that is flaky?

@RaoulLuque
Copy link
Member

RaoulLuque commented Jun 21, 2025

I would merge this PR anyway, right? Since adding this markdown file should certainly not be the issue, right? 🤔

@starovoid starovoid added this pull request to the merge queue Jun 21, 2025
Merged via the queue into master with commit 7a6be63 Jun 21, 2025
18 checks passed
@starovoid starovoid deleted the algodocs-deflts branch June 21, 2025 21:49
@starovoid
Copy link
Collaborator Author

system-related as in GitHub CI runners or something in the crate that is flaky?

Maybe something changed in the testing env, and now the quickcheck test for the SPFA algorithm is failing. We need to change this test by not calling .unwrap() and comparing spfa results with bellman_ford.

thread 'test_spfa' panicked at tests/quickcheck.rs:1638:53:
called `Result::unwrap()` on an `Err` value: NegativeCycle(())
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

RaoulLuque added a commit to RaoulLuque/petgraph that referenced this pull request Sep 21, 2025
This PR removes the \[Generic\] tag from the docstrings of algorithms as
discussed
[here](petgraph#834 (comment)).
RaoulLuque pushed a commit to RaoulLuque/petgraph that referenced this pull request Sep 21, 2025
This PR adds a file describing the approach to documenting algorithms.

In the future, this file will be referenced by `CONTRIBUTING.md` and any
other instructions for adding new algorithms.

---------

Co-authored-by: Agustín Borgna <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-readme Area: Documentation that isn't part of any crate such as README.md or CONTRIBUTING.rst

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants