View Issue Details

IDProjectCategoryView StatusLast Update
0005697Talerdocumentationpublic2019-12-20 18:11
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
PrioritynormalSeverityminorReproducibilityhave not tried
Status closedResolutionfixed 
Product Versiongit (master) 
Target Version0.6Fixed in Version0.6 
Summary0005697: Polishnig onboard.texi.
DescriptionThe file deployment/doc/onboard.texi has been partially obsoleted by readme.md from gv-maintenance.git. It should be seen whether this file should be simply polished, or entirely disposed.
TagsNo tags attached.

Required notifications

Address or linkRemarkAdded byNotifiedActions

Activities

Marcello Stanisci

2019-04-19 15:49

reporter   ~0014304

first cleaning: 42a3311..ddcfb1b

Christian Grothoff

2019-04-20 10:08

manager   ~0014310

I generally believe the onboarding.texi should be kept. It should have a much broader scope than just gv-maintenance.git, which is about system administration. Onboarding is about "everything" a new dev should know (from Git write access to Bugtracking to CI to coding conventions, etc. etc.). Naturally details about system administration might be better kept in the gv-maintenance.git readme.

Marcello Stanisci

2019-04-22 13:58

reporter   ~0014327

Okay for all, but 'CI' needs some clarification: this aspect has the sysadmin side (accounting for which users are running which workers, or where in the system some worker outputs some files, etc.) and the user side (like letting the user know where the BB Website is, or what happens after they push their changes, etc.).

We should agree that the first part goes in gv-maintenance.git, and the second goes in onboarding.texi at deployment.git.

Marcello Stanisci

2019-04-22 16:24

reporter   ~0014329

In 875fdb95058e0..c42dbea3cda4a2ab, I reviewed and polished the per-user setup environments. Actually, we should also agree about keeping this feature around or not.

Marcello Stanisci

2019-04-22 16:30

reporter   ~0014330

Commit 99a3eee..5536720 finishes polishing the current content, and so this can be closed. New sections, like about Git / Bugtracking / Buidlbot for *users* needs to be added.

Issue History

Date ModifiedUsernameFieldChange
2019-04-19 15:40Marcello StanisciNew Issue
2019-04-19 15:49Marcello StanisciNote Added: 0014304
2019-04-20 10:08Christian GrothoffNote Added: 0014310
2019-04-22 13:58Marcello StanisciNote Added: 0014327
2019-04-22 16:24Marcello StanisciNote Added: 0014329
2019-04-22 16:30Marcello StanisciNote Added: 0014330
2019-04-22 16:30Marcello StanisciAssigned To => Marcello Stanisci
2019-04-22 16:30Marcello StanisciStatusnew => informing
2019-04-22 16:30Marcello StanisciResolutionopen => fixed
2019-09-16 07:24Christian GrothoffProduct Version => git (master)
2019-09-16 07:24Christian GrothoffFixed in Version => 0.6
2019-09-16 07:24Christian GrothoffTarget Version => 0.6
2019-12-20 18:11Christian GrothoffStatusinforming => closed