stove/rougail
3
0
Fork 0
Code Issues 10 Pull requests 1 Projects Releases Wiki Activity

doc: explain better the "submulti" status for a follower #15

New issue
Open
opened 2024-06-04 11:20:50 +02:00 by gremond · 0 comments
gremond commented 2024-06-04 11:20:50 +02:00
Member
Copy link

This part of the documentation :

https://rougail.readthedocs.io/en/latest/family.html#follower-variable

is not speaking at all, in the code it is the concept of submulti, in the doc it is not obvious. Maybe a concrete example of a "multi of multi" could be usefull here.

For example, let's say we have a database. More precisely, we have multiple databases.

The leader variable describes one (or many) database names.
The follower variable describes the list of users of a database.

We see clearly in this example that

  • a database needs a list of users
  • another database needs another list of users.

The follower variable is a list (the list of users) of list (for each database).

Moreover, a the follower variable shall not be a unique value but shall keep as a list. This is the keypoint.

This part of the documentation : https://rougail.readthedocs.io/en/latest/family.html#follower-variable is not speaking at all, in the code it is the concept of `submulti`, in the doc it is not obvious. Maybe a concrete example of a "multi of multi" could be usefull here. For example, let's say we have a database. More precisely, we have multiple databases. The leader variable describes one (or many) database names. The follower variable describes the list of users of a database. We see clearly in this example that - a database needs a list of users - another database needs another list of users. The follower variable is a list (the list of users) of list (for each database). Moreover, a the follower variable shall not be a unique value but shall keep as a list. This is the keypoint.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
develop
docs_update
docs
developer_docs
1.1.1
1.1.1rc0
1.1.0
1.1.0rc0
1.0.2
1.0.1
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: stove/rougail#15
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?