stove/rougail
3
0
Fork 0
Code Issues 11 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
docs_update
develop
docs
developer_docs
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?