Skip to content

Create docs page for ephemeral_verifications.adoc #187

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: develop
Choose a base branch
from

Conversation

NilHomedes
Copy link
Member

@NilHomedes NilHomedes commented Apr 8, 2025

Adding documentation page for Ephemeral Verification feature.

The images are missing. You can take it from here: https://www.notion.so/decidim/1badea4aebbe8054aa0ccde288736d91

Adding documentation page for Ephemeral Verification feature.

The images are missing.
@@ -1,3 +1,81 @@
= Ephemeral verifications

TBD
## Understand the basics
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Understand the basics
== Understand the basics

The titles should follow the same format (with = instead of #)


In Decidim, there are mainly two types of participants:

- One-time participants: Users who access the platform for a single action, such as voting in participatory budgets, and do not return.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- One-time participants: Users who access the platform for a single action, such as voting in participatory budgets, and do not return.
- One-time participants: Users who access the platform for a single action, such as voting in participatory budgets, and don't return.

In Decidim, there are mainly two types of participants:

- One-time participants: Users who access the platform for a single action, such as voting in participatory budgets, and do not return.
- Recurrent participants**:** Users who engage regularly in different participatory processes.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Recurrent participants**:** Users who engage regularly in different participatory processes.
- Recurrent participants: Users who engage regularly in different participatory processes.


For one-time participants, the registration and verification process can be a barrier, leading to incomplete participation. To address this, Decidim introduces the Ephemeral Verification Method, allowing users to verify their identity and participate without registering an account.

### Purpose
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Purpose
=== Purpose


The Ephemeral Verification Method is designed to streamline participation for one-time users by enabling direct verification without requiring account creation. **This feature is intended for limited durations** **during a specific participatory process**, such as a voting phase of participatory budgeting.

### How it works?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### How it works?
=== How it works?

5. And I gain access to the restricted action
6. When I completed the task (i.e. voting in a participatory budget). Then I can quit the focus mode and the temporary session will be closed.

### Flow 2) Registered participant with logged-in session:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Flow 2) Registered participant with logged-in session:
=== Flow 2: Registered participant with logged-in session

4. Then I gain access to the restricted action
5. Then, the verification is saved in my profile

### Edge cases
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Edge cases
=== Edge cases


### Edge cases

### Flow 3) Preventing Verification Conflicts
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Flow 3) Preventing Verification Conflicts
==== Flow 3: Preventing Verification Conflicts

2. The system detects a verification conflict.
3. Then, I’m prevented from proceeding with the verification.

### Flow 4) Merging Ephemeral and Registered Accounts
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### Flow 4) Merging Ephemeral and Registered Accounts
==== Flow 4: Merging Ephemeral and Registered Accounts

4. The system retrieves and merges your ephemeral user data with your new registered account.
5. You can now view and edit your votes.

### How the ephemeral session work?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
### How the ephemeral session work?
=== How does the ephemeral session work?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants