View Issue Details

IDProjectCategoryView StatusLast Update
0009441Talerdocumentationpublic2025-01-07 22:35
Reporteroec Assigned To 
PrioritynormalSeveritytextReproducibilityalways
Status confirmedResolutionopen 
Product Versiongit (master) 
Target Version1.0 
Summary0009441: Protocol version missing in public documentation
DescriptionThe public documentation at docs.taler.net, and there under "Core Protocol Specification",
none of the protocol API's (exchange, merchant, auditor etc.)
mention their current version of their protocol.

I suggest that for each API, the protocol version should be
- part of the "Overview" section
- prominently and consistently presented in the introduction of each API
- (if possible) automatically synchronized with the versions set in the main branches of the respective API repos
TagsNo tags attached.

Activities

Christian Grothoff

2025-01-07 22:34

manager   ~0023945

Eh, they all do mention this under /config. I'm not against moving this up or making it more prominent, but it is not *missing*.

Christian Grothoff

2025-01-07 22:35

manager   ~0023946

As far as automatic sync goes, that should *not* be done, as we _do_ sometimes write specs before implementation, and/or may have an implementation in a branch but the spec already in master, etc.

Issue History

Date Modified Username Field Change
2025-01-07 13:24 oec New Issue
2025-01-07 13:24 oec Status new => assigned
2025-01-07 13:24 oec Assigned To => Christian Grothoff
2025-01-07 22:34 Christian Grothoff Note Added: 0023945
2025-01-07 22:35 Christian Grothoff Note Added: 0023946
2025-01-07 22:35 Christian Grothoff Assigned To Christian Grothoff =>
2025-01-07 22:35 Christian Grothoff Severity feature => text
2025-01-07 22:35 Christian Grothoff Status assigned => confirmed