View Issue Details

IDProjectCategoryView StatusLast Update
0003965Talerwallet (WebExtension)public2019-12-26 20:37
ReporterMarcello Stanisci Assigned ToMarcello Stanisci Resolution deadline
ImplementerReviewer 
Release signed byDeployed by 
VerifierCommunicator 
Data protection authority notification requiredNo  
CSIRT notification requiredNo  
Estimated effort (hours)Actual effort (hours)0 
Fast-trackNo
Work packagenone
PrioritynoneSeveritytextReproducibilityhave not tried
Status closedResolutionfixed 
Product Versiongit (master) 
Target Version0.0 
Summary0003965: Documenting the JavaScript
DescriptionAs of now, the JS uses no structured commenting style.
Do we want to switch to a structured commenting style?

(A quick search shows that 'JSDoc' is a choice, but there
is also a JS flavour of doxygen)
TagsNo tags attached.

Required notifications

Address or linkRemarkAdded byNotifiedActions

Activities

Marcello Stanisci

2015-10-09 20:08

reporter   ~0009719

Make some cleaning like getting rid of variables names 'aSomething',
extend names like 'resPub' to 'reservePub'

Christian Grothoff

2015-10-17 22:59

manager   ~0009741

Yes, we definitively want some structured style for comments. How is the tool support? In particular, can we get warnings generated for missing/malformed comments?

Marcello Stanisci

2015-12-04 15:16

reporter   ~0009975

http://usejsdoc.org seems easy to set up, and is doxygen-styled.

Marcello Stanisci

2015-12-06 19:22

reporter   ~0009979

commenting 90% of the code. A way to comment object and crossreference
them is still needed. 'make doc' entry to Makefile needed too.

Marcello Stanisci

2015-12-06 19:39

reporter   ~0009980

http://stackoverflow.com/questions/6460604/how-to-describe-object-arguments-in-jsdoc

Marcello Stanisci

2015-12-11 17:35

reporter   ~0009994

fixed in c7d344d. 'make doc' still missing but not striclty this bug's goal

Issue History

Date ModifiedUsernameFieldChange
2015-09-09 08:34Marcello StanisciNew Issue
2015-09-09 08:34Marcello StanisciStatusnew => assigned
2015-09-09 08:34Marcello StanisciAssigned To => Marcello Stanisci
2015-09-19 18:38Christian GrothoffSeveritytrivial => text
2015-10-09 20:08Marcello StanisciNote Added: 0009719
2015-10-17 22:59Christian GrothoffNote Added: 0009741
2015-10-17 22:59Christian GrothoffTarget Version => 0.0
2015-10-22 23:10Christian GrothoffProduct Version => git (master)
2015-12-04 15:16Marcello StanisciNote Added: 0009975
2015-12-06 19:22Marcello StanisciNote Added: 0009979
2015-12-06 19:39Marcello StanisciNote Added: 0009980
2015-12-11 17:35Marcello StanisciNote Added: 0009994
2015-12-11 17:35Marcello StanisciStatusassigned => informing
2015-12-11 17:35Marcello StanisciResolutionopen => fixed
2015-12-12 10:43Christian GrothoffStatusinforming => closed
2019-12-26 20:37Florian DoldCategorywallet (browser-based) => wallet (WebExtensions)
2023-04-13 18:37Florian DoldCategorywallet (WebExtensions) => wallet (WebExtension)