View Issue Details

Jump to NotesJump to History
IDProjectCategoryView StatusDate SubmittedLast Update
0006696Talerdocumentationpublic2021-01-13 23:502025-05-20 11:55
ReporterFlorian Dold Assigned To 
PrioritynormalSeveritytextReproducibilityhave not tried
Status confirmedResolutionopen 
Target Versionpost-1.0 
Summary0006696: discuss better structure for LibEuFin docs
DescriptionThe LibEuFin docs are currently pretty chaotic. We should come up with a better structure.

I guess there are three different target audiences for the docs:
* Operators of LibEuFin (who want to use it with Taler)
* Developers who want to use the LibEuFin API
* Core Developers of LibEuFin ("internal stuff, documented in public")
TagsNo tags attached.

Relationships

related to 0009973 resolvedAntoine A libeufin 'make install' fails to install libeufin-bank man pages 
related to 0007147 closedAntoine A libeufin-{sandbox,nexus,cli} needs a manpage 

Activities

ttn

2021-01-29 19:42

developer   ~0017449

Well, the HOWTO (tutorial) is clearly targeted at the Operator audience. I don't know what the distinction is between the other two audience groups are, however.

ttn

2021-02-02 21:34

developer   ~0017490

Applicable not just to Libeufin, but all Taler documentation:
https://documentation.divio.com/

ttn

2021-08-11 04:55

developer   ~0018093

Please see recent commits in docs.git/libeufin/*.rst --
the "target audience" can be "operator", "developer", "core developer".
(Feel free to add/correct my guesses.)

ttn

2022-01-12 02:25

developer   ~0018632

Just managed to "manually" build/install libeufin. When i tried to run libeufin-cli, i saw an error:

 ModuleNotFoundError: No module named 'click'

This makes sense since i don't have that module installed on my system (yet).
Anyway, we should probably document these runtime dependencies, and additionally
make sure the Debian packaging declares them so that they are installed automatically.

how

2025-05-19 09:28

developer   ~0024927

The documentation at https://docs.taler.net/libeufin/bank-manual.html#id5 mentions:

> Refer to the manpage libeufin-man.conf(5) for the full array of configuration values.

But the manual page does not seem to be available as a Debian package (I installed `libeufin-bank` from `apt`).

Issue History

Date Modified Username Field Change
2021-01-13 23:50 Florian Dold New Issue
2021-01-13 23:50 Florian Dold Status new => assigned
2021-01-13 23:50 Florian Dold Assigned To => ttn
2021-01-29 19:42 ttn Note Added: 0017449
2021-01-30 23:55 Christian Grothoff Severity minor => text
2021-02-02 21:34 ttn Note Added: 0017490
2021-06-02 09:58 Christian Grothoff Assigned To ttn => Christian Grothoff
2021-07-13 06:48 Christian Grothoff Assigned To Christian Grothoff => ttn
2021-08-11 04:55 ttn Note Added: 0018093
2022-01-11 11:06 ttn Relationship added related to 0007147
2022-01-12 02:25 ttn Note Added: 0018632
2022-08-25 21:11 Christian Grothoff Project Taler => libeufin
2023-01-08 11:29 Christian Grothoff Target Version => 0.11
2023-04-13 20:29 Florian Dold Project libeufin => Taler
2023-04-13 21:59 Christian Grothoff Assigned To ttn => MS
2023-09-03 18:18 Christian Grothoff Assigned To MS => Antoine A
2023-12-22 14:35 Christian Grothoff Target Version 0.11 => post-1.0
2025-04-24 00:55 Christian Grothoff Assigned To Antoine A =>
2025-04-24 00:55 Christian Grothoff Status assigned => confirmed
2025-05-19 09:28 how Note Added: 0024927
2025-05-20 11:55 schanzen Relationship added related to 0009973