Skip to content

Add miscellaneous missing docs - #960

Open
William-Kenyon wants to merge 8 commits into
digraphs:mainfrom
William-Kenyon:misc-missing-docs
Open

William-Kenyon wants to merge 8 commits into
digraphs:mainfrom
William-Kenyon:misc-missing-docs

Conversation

@William-Kenyon

Copy link
Copy Markdown
Collaborator

I used a small script to find instances where Declare...("name", ...) existed but had no corresponding mansection, i.e. no <Oper/Attr/Prop/... name="name" ...>, and updated the docs where appropriate. Excluding ...Cons, ...NC, DIGRAPHS_... etc.

@codecov

codecov Bot commented Oct 25, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.48%. Comparing base (9529aae) to head (dd7f710).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #960   +/-   ##
=======================================
  Coverage   97.48%   97.48%           
=======================================
  Files          53       53           
  Lines       21363    21363           
  Branches      639      639           
=======================================
  Hits        20825    20825           
  Misses        473      473           
  Partials       65       65           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@james-d-mitchell james-d-mitchell left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

A couple of minor TODOs, then we'll be happy to merge, thanks @William-Kenyon this is super helpful!

Comment thread doc/grahom.xml

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

There seems to be a TODO:

gap/grahom.gd:45:DeclareAttribute("DigraphSmallestLastOrder", IsDigraph);  # TODO: document

which you could also delete.

Comment thread doc/weights.xml
<Description>
<C>UnitEdgeWeightedDigraph</C> returns an edge-weighted copy of
<A>digraph</A>, with all edge weights set to 1.<P/>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

There should be a statement about what happens when digraph is mutable/immutable here.

Comment thread doc/weights.xml
<Prop Name="IsNegativeEdgeWeightedDigraph" Arg="digraph"/>
<Returns>A boolean.</Returns>
<Description>
This returns <C>true</C> if <A>digraph</A> contains at least one edge

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
This returns <C>true</C> if <A>digraph</A> contains at least one edge
This returns <K>true</K> if <A>digraph</A> contains at least one edge

K for "keyword"

Comment thread doc/weights.xml
<Description>
This returns <C>true</C> if <A>digraph</A> contains at least one edge
with negative weight, and <C>false</C> otherwise.
<Example><![CDATA[

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Ideally the doc would also say what happens when digraph doesn't have edge weights.

@james-d-mitchell james-d-mitchell added the doc Issues, bugs, pull requests relating to the documentation label Oct 26, 2026

This branch has not been deployed

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

Labels

doc Issues, bugs, pull requests relating to the documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants