From 79153f5c628e420842c710f99b93a4413a0c61fe Mon Sep 17 00:00:00 2001 From: scx1332 Date: Wed, 31 Jul 2024 17:48:25 +0200 Subject: [PATCH] readme --- utils/consent/README.md | 37 ++++++++++++++++++++----------------- 1 file changed, 20 insertions(+), 17 deletions(-) diff --git a/utils/consent/README.md b/utils/consent/README.md index a5dba4c4b..315c0e3db 100644 --- a/utils/consent/README.md +++ b/utils/consent/README.md @@ -1,35 +1,38 @@ -Feature Documentation +## Feature Documentation -Aim: +### Aim: Add a management feature to allow users to set their consent for data collection and publishing on the stats.golem.network. -Description: +### Description: The user setting for the consent is saved in the CONSENT file, in the YAGNA_DATADIR folder. -Both Yagna and Golemsp use the config (see details below). +Both ```yagna``` and ```golemsp``` use the config (see details below). The setting can be modified by using the YA_CONSENT_STATS env variable (that can be read from the .env file). -Used artefacts: +### Used artefacts: YA_CONSENT_STATS - env, the value set by the variable has priority and is used to update the setting in the CONSENT file when yagna or golemsp is run CONSENT file in the YAGNA_DATADIR folder -How to check the settings: +### How to check the settings: - `yagna consent show`: - Shows the current setting, - Note it reads the value from the CONSENT file and the value of the YA_CONSENT_STATS variable (from session or .env file in the pwd folder) so if the service was launched from another folder or with a different value of YA_CONSENT_STATS set in the session the information shown setting may be not accurate. +Shows the current setting, +``` +yagna consent show +``` +Note it reads the value from the CONSENT file and the value of the YA_CONSENT_STATS variable (from session or .env file in the pwd folder) so if the service was launched from another folder or with a different value of YA_CONSENT_STATS set in the session the information shown setting may be not accurate. -How to change the settings: +### How to change the settings: -- yagna consent allow/deny : set the new setting in the CONSENT file, requires yagna restart to take effect. +set the new setting in the CONSENT file, requires yagna restart to take effect. +- yagna consent allow/deny - restart yagna/golemsp with YA_CONSENT_STATS set, the setting in the CONSENT file will be updated to the value set by the variable. -Details: +### Details: - golemsp will ask the question about the consent if it cannot be determined from the YA_CONSENT_STATS variable or CONSENT file. - If Yagna cannot determine the settings from the YA_CONSENT_STATS variable or CONSENT file it will assume the consent is not given, but will not set it in the CONSENT file. +```golemsp``` will ask the question about the consent if it cannot be determined from the YA_CONSENT_STATS variable or CONSENT file. +If Yagna cannot determine the settings from the YA_CONSENT_STATS variable or CONSENT file it will assume the consent is not given, but will not set it in the CONSENT file. -Motivation: -golemsp is designed to install the provider nodes interactively. Therefore it will expect the question to be answered. The user still can avoid the question by setting the env variable. +### Motivation: +```golemsp``` is designed to install the provider nodes interactively. Therefore, it will expect the question to be answered. The user still can avoid the question by setting the env variable. The default answer is "allow" as we do not collect data that is both personal and not already publicly available for the other network users. The data is used to augment the information shown on the stats.golem.network and most of the providers expect these data to be available there. -Yagna on the other hand will not ask the question and will not stop if the setting is not defined, to prevent the interruption of automatic updates of Yagna that run as a background service. +Yagna on the other hand won't stop on the question if the setting is not defined, to prevent the interruption of automatic updates of Yagna that run as a background service. We expect such a scenario mostly for requestors. \ No newline at end of file