Make sure that documentation of sipnet.out header reflects implementation

Open Beginner friendly
#345 8 comments 1 reaction 0 assignees View on GitHub

Maintainers usually reply within 2 days

@TianHengZhuang is already working on this.

Since Oct 20, 2026.

  • #347 by @Rahmankhan3 — closed without merging
  • #410 by @TianHengZhuang — open

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
65/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Tech stack
markdown
Domain
documentation

Research direction

Start with docs/user-guide/model-outputs.md and compare its output table with the column list in a real sipnet.out header, checking that the source code that writes the header agrees with it. Add the missing nppStorage, bcdeltaC and bcdeltaN entries, then renumber the columns consecutively. Done when every header column is documented and the example header matches the smoke test output.

Written by the indexing model from the issue text.

Description

documentation good first issue

Updated scope & specification

Task

  • Update docs/user-guide/model-outputs.md to match current supported outputs.

Requirements

  • Match column names and order in outputHeader(); verify definitions and units against implementation.
  • Distinguish pools, rates, timestep totals, cumulative quantities, time coordinates, and diagnostics.
  • Retain nppStorage as an accounting diagnostic, pending maintainer confirmation. Explain that it is included in reported plantWoodC.
  • Exclude obsolete columns found only in disabled historical outputs, including microbeC, bcdeltaC, and bcdeltaN.
  • Verify example headers and rows against an active smoke test.
Dominant language
C
Stars
42
Forks
38
Avg merge
3d 21h
Merged PRs (30d)
10

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from PecanProject/sipnet

All issues in PecanProject/sipnet

Similar issues

More C issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.