diff --git a/docs/assets/styles/scopes-proposal.css b/docs/assets/styles/scopes-proposal.css index 8c9d883..e89c8cc 100644 --- a/docs/assets/styles/scopes-proposal.css +++ b/docs/assets/styles/scopes-proposal.css @@ -111,6 +111,7 @@ .scp-tag[data-level="mesh"] { color: var(--scp-mesh); background: var(--scp-mesh-bg); } .scp-tag[data-level="any"] { color: var(--scp-any); background: var(--scp-any-bg); } .scp-tag[data-level="bad"] { color: var(--scp-drop); background: var(--scp-drop-bg); } +.scp-tag[data-level="future"] { color: var(--scp-any); background: transparent; border-style: dashed; } /* ---------- Summary cards ---------- */ @@ -323,6 +324,11 @@ .scp-zone[data-level="mesh"] { --scp-zone: var(--scp-mesh); --scp-zone-bg: var(--scp-mesh-bg); } .scp-zone[data-level="prov"] { --scp-zone: var(--scp-prov); --scp-zone-bg: var(--mc-color-surface); } +.scp-zone[data-level="future"] { + --scp-zone: var(--scp-any); + --scp-zone-bg: transparent; + border-style: dashed; +} .scp-zone__title { display: flex; diff --git a/docs/proposals/onqc-scopes.fr.md b/docs/proposals/onqc-scopes.fr.md index f6837e6..37733e8 100644 --- a/docs/proposals/onqc-scopes.fr.md +++ b/docs/proposals/onqc-scopes.fr.md @@ -24,7 +24,7 @@ page_styles:

Proposition à discuter

-

Les portées de région empêchent les échanges locaux d’inonder tout le réseau. La configuration actuelle est difficile à suivre. Cette proposition la ramène à trois codes faciles à retenir partout en Ontario et au Québec.

+

Les portées de région empêchent les échanges locaux d’inonder tout le réseau. La configuration actuelle est difficile à suivre. Cette proposition la ramène à trois niveaux de codes faciles à retenir partout en Ontario et au Québec.

-- **Les répéteurs** portent leur ville, leur province et `onqc`. +- **Les répéteurs** portent leur ville, leur province, `onqc` et `can`. - **Les téléphones** utilisent `onqc` par défaut, pour que les messages privés joignent tout le monde. - **Les canaux locaux** comme `#public` sont réglés sur votre ville, pour que @@ -96,6 +96,7 @@ avec cinq messages différents. yow on onqc + can Sa liste de noms à relayer @@ -130,6 +131,8 @@ Trois détails piègent souvent : ## Les trois niveaux
+
+

can Canada Réservé pour plus tard. Porté dès maintenant, pas encore utilisé.

onqc Réseau Tous les répéteurs de l’Ontario et du Québec

@@ -146,23 +149,36 @@ Trois détails piègent souvent :

qc Québec

-
yulMontréal, Trois-Rivières, Rigaud
+
yulMontréal, Trois-Rivières
yqbVille de Québec
-
yowGatineau (partagé avec Ottawa)
+
yowGatineau, Rigaud (partagé avec Ottawa)
ytfSaguenay–Lac-Saint-Jean
…Autres zones MeshMapper
+
Ce qu’un répéteur d’Ottawa garde vraiment : - *yowononqc + *yowononqccan Une simple liste de noms. Les boîtes ci-dessus servent aux gens, pas au répéteur.
La zone yow traverse la rivière des Outaouais. Les répéteurs de Gatineau utilisent yow pour leur ville et qc pour leur province.
+### Et `can`? + +Chaque répéteur porte `can` dès maintenant pour qu’une portée pancanadienne +fonctionne plus tard sans que personne n’ait à reconfigurer son répéteur. Bien +des répéteurs configurés avec le configurateur actuel le portent déjà. + +**N’utilisez pas encore `can` sur votre téléphone ni dans vos canaux.** +Aujourd’hui, il joint les mêmes répéteurs que `onqc`. Continuez d’utiliser +`onqc`. Quand d’autres provinces porteront aussi `can`, il deviendra la façon +d’aller plus loin, et `onqc` restera « seulement le réseau de l’Ontario et du +Québec ». + ### Pourquoi des codes d’aéroport? - Ce sont les mêmes codes que MeshMapper utilise déjà, par exemple @@ -176,20 +192,22 @@ Trois détails piègent souvent : La première fois, écrivez toujours le code avec son secteur, par exemple `yow` (secteur Ottawa–Gatineau), pour que les gens l’apprennent. -## Lire `region def yow|* on|* onqc` +## Lire `region def yow|* on|* onqc|* can` `region def` construit la liste d’un répéteur en une ligne. La commande garde un **curseur** qui part du sommet, `*`. Chaque nom est créé sous le curseur, et `|*` ramène le curseur au sommet.
-
+
region def 1yow 2|* 3on 4|* 5onqc + 6|* + 7can
  1. Crée yow sous le curseur. Le curseur entre dans yow.
    * @@ -202,10 +220,19 @@ La première fois, écrivez toujours le code avec son secteur, par exemple
  2. |* ramène encore le curseur au sommet.
    * ├ yow └ on
    3. -
  3. Crée onqc. Terminé.
    * +
  4. Crée onqc.
    * ├ yow ├ on └ onqc
    5. +
  5. |* ramène au sommet.
    * +├ yow +├ on +└ onqc
    6. +
  6. Crée can. Terminé.
    * +├ yow +├ on +├ onqc +└ can
Le résultat est une liste à plat : tous les codes sont côte à côte sous *. Le nom surligné indique la position du curseur.
@@ -240,8 +267,8 @@ region remove can region save ``` -Retirer `on` ne pose pas de problème. Les réglages de région de l’étape 3 le -remettent. Lancez `region` de nouveau : vous ne devriez voir que `* F`. +Retirer `on` et `can` ne pose pas de problème. Les réglages de région de +l’étape 3 les remettent. Lancez `region` de nouveau : vous ne devriez voir que `* F`. ### Étape 2 : Réglages standard de MeshCore Canada @@ -269,7 +296,7 @@ donc rien de nouveau à chercher. Le modèle est toujours le même : ```text -region def |* |* onqc +region def |* |* onqc|* can ``` Exemples : @@ -277,7 +304,7 @@ Exemples : === "Ottawa" ```text - region def yow|* on|* onqc + region def yow|* on|* onqc|* can region allowf * region default yow region save @@ -286,7 +313,7 @@ Exemples : === "Gatineau" ```text - region def yow|* qc|* onqc + region def yow|* qc|* onqc|* can region allowf * region default yow region save @@ -295,7 +322,7 @@ Exemples : === "Montréal" ```text - region def yul|* qc|* onqc + region def yul|* qc|* onqc|* can region allowf * region default yul region save @@ -304,14 +331,14 @@ Exemples : === "Ville de Québec" ```text - region def yqb|* qc|* onqc + region def yqb|* qc|* onqc|* can region allowf * region default yqb region save ```
-
region def …
Porter votre ville, votre province et onqc.
+
region def …
Porter votre ville, votre province, onqc et can.
region allowf *
Relayer aussi les messages sans portée. C’est déjà le réglage par défaut. On le règle quand même pour que vous le voyiez.
region default yow
Les annonces de ce répéteur utilisent la portée de votre ville, pour rester locales.
region save
Conserve les réglages de région après un redémarrage. Les commandes set s’enregistrent d’elles-mêmes.
@@ -324,6 +351,7 @@ Pour vérifier, lancez `region`. Pour Ottawa, vous devriez voir : yow F on F onqc F + can F ``` `F` veut dire « diffusion permise » : le répéteur relaie ce nom. @@ -332,17 +360,17 @@ Pour vérifier, lancez `region`. Pour Ottawa, vous devriez voir : Un répéteur qui relie volontairement deux zones de ville porte **les deux** codes de ville. Par exemple, un répéteur à **Rigaud** se trouve dans la zone -`yul` et relie Montréal à la zone d’Ottawa : +`yow`, du côté québécois, et la relie à la zone de Montréal : ```text -region def yul|* yow|* qc|* onqc +region def yow|* yul|* qc|* onqc|* can region allowf * -region default yul +region default yow region save ``` -Il relaie les messages de ville d’Ottawa et de Montréal, ainsi que `qc` et -`onqc`. Ses propres annonces restent dans sa zone, `yul`. N’ajoutez une ville +Il relaie les messages de ville d’Ottawa et de Montréal, ainsi que `qc`, +`onqc` et `can`. Ses propres annonces restent dans sa zone, `yow`. N’ajoutez une ville voisine que si le répéteur relie vraiment les deux secteurs; sinon, les messages de ville iront plus loin que prévu. @@ -378,9 +406,9 @@ défaut **de votre contact**.
Portée par défaut yowN’arrive jamais
  1. Vous, Ottawaenvoie yow
    2. -
  2. Répéteur d’Ottawayow on onqc
    3. -
  3. Répéteur de Montréalyul qc onqc
    4. -
  4. Répéteur de Québecyqb qc onqc
    5. +
  5. Répéteur d’Ottawayow on onqc can
    6. +
  6. Répéteur de Montréalyul qc onqc can
    7. +
  7. Répéteur de Québecyqb qc onqc can
  8. Ami, Québecdéfaut yqb

Le répéteur de Montréal ne porte pas yow, donc le message s’arrête là. Même s’il passait, la réponse de votre ami utiliserait yqb et s’arrêterait au retour.

@@ -389,9 +417,9 @@ défaut **de votre contact**.
Portée par défaut onqcLivré
  1. Vous, Ottawaenvoie onqc
    2. -
  2. Répéteur d’Ottawayow on onqc
    3. -
  3. Répéteur de Montréalyul qc onqc
    4. -
  4. Répéteur de Québecyqb qc onqc
    5. +
  5. Répéteur d’Ottawayow on onqc can
    6. +
  6. Répéteur de Montréalyul qc onqc can
    7. +
  7. Répéteur de Québecyqb qc onqc can
  8. Ami, Québecdéfaut onqc

Tous les répéteurs portent onqc, dans les deux sens. Une fois le chemin trouvé, les MP suivants passent directement et les portées ne comptent plus.

@@ -409,7 +437,7 @@ téléphone règle les canaux locaux sur votre ville. ## Déploiement
    -

  1. Répéteurs

    Les propriétaires effacent les anciennes régions, ajoutent leurs trois codes et gardent * permis. Rien ne brise pour personne.

    2. +

  2. Répéteurs

    Les propriétaires effacent les anciennes régions, ajoutent leurs codes et gardent * permis. Rien ne brise pour personne.

  3. Téléphones

    Les utilisateurs règlent leur portée par défaut sur onqc et leurs canaux locaux sur leur ville.

  4. Bascule

    À une date convenue, les répéteurs lancent set flood.max.unscoped 3. Les messages sans portée restent alors à 3 sauts ou moins, tandis que les messages avec portée atteignent encore 16 sauts.

diff --git a/docs/proposals/onqc-scopes.md b/docs/proposals/onqc-scopes.md index d1ce6a4..f3bd32a 100644 --- a/docs/proposals/onqc-scopes.md +++ b/docs/proposals/onqc-scopes.md @@ -24,7 +24,7 @@ page_styles:

Proposal for discussion

-

Region scopes stop local chatter from flooding the whole network. Today's setup is hard to follow, so this proposal cuts it down to three codes that everyone in Ontario and Québec can remember.

+

Region scopes stop local chatter from flooding the whole network. Today's setup is hard to follow, so this proposal cuts it down to three levels of codes that everyone in Ontario and Québec can remember.

  • Not adopted yet
  • Ontario + Québec pilot
    • @@ -35,7 +35,7 @@ page_styles: ## The short version -There are three levels of scope. Every repeater carries one code from each level: its city, its province, and `onqc`. When you send a message, you choose which level to use, and that decides how far it travels. +There are three levels of scope. Every repeater carries its city, its province, and the mesh codes `onqc` and `can`. When you send a message, you choose which level to use, and that decides how far it travels.
    @@ -50,12 +50,12 @@ There are three levels of scope. Every repeater carries one code from each level

    Mesh

    - onqc -

    Every repeater in Ontario and Québec.

    + onqc can +

    onqc: every repeater in Ontario and Québec. can: all of Canada, reserved for later.

    -- **Repeaters** carry their city, their province, and `onqc`. +- **Repeaters** carry their city, their province, `onqc` and `can`. - **Phones** use `onqc` as their default, so direct messages reach anyone. - **Local channels** such as `#public` are set to your city, so chatter stays local. - **Messages with no scope** keep working during the pilot. @@ -90,6 +90,7 @@ different messages. yow on onqc + can
Its list of names to forward @@ -122,6 +123,8 @@ Three details catch people out: ## The three levels
+
+

can Canada Reserved for later. Carried now, not used yet.

onqc Mesh Every repeater in Ontario and Québec

@@ -138,23 +141,35 @@ Three details catch people out:

qc Québec

-
yulMontréal, Trois-Rivières, Rigaud
+
yulMontréal, Trois-Rivières
yqbQuébec City
-
yowGatineau (shared with Ottawa)
+
yowGatineau, Rigaud (shared with Ottawa)
ytfSaguenay–Lac-Saint-Jean
…Other MeshMapper zones
+
What an Ottawa repeater actually stores: - *yowononqc + *yowononqccan A flat list of names. The boxes above are for people, not for the repeater.
The yow zone crosses the Ottawa River. Gatineau repeaters use yow for their city and qc for their province.
+### What about `can`? + +Every repeater carries `can` now so that a Canada-wide scope works later +without anyone having to reconfigure their repeater again. Many repeaters set +up with the current configurator already carry it. + +**Don't use `can` on your phone or channels yet.** Today it reaches the same +repeaters as `onqc`. Keep using `onqc`. Once other provinces carry `can` too, +it becomes the way to reach further, and `onqc` stays as "just the Ontario and +Québec mesh". + ### Why airport codes? - They are the same codes MeshMapper already uses, for example @@ -167,20 +182,22 @@ Three details catch people out: Always write the code with its area the first time, for example `yow` (Ottawa / NCR area), so people learn it. -## Reading `region def yow|* on|* onqc` +## Reading `region def yow|* on|* onqc|* can` `region def` builds a repeater's list in one line. It keeps a **cursor** that starts at the top, `*`. Each name is created under the cursor, and `|*` jumps the cursor back to the top.
-
+
region def 1yow 2|* 3on 4|* 5onqc + 6|* + 7can
  1. Create yow under the cursor. The cursor moves into yow.
    * @@ -193,10 +210,19 @@ the cursor back to the top.
  2. |* jumps back to the top again.
    * ├ yow └ on
    3. -
  3. Create onqc. Done.
    * +
  4. Create onqc.
    * ├ yow ├ on └ onqc
    5. +
  5. |* back to the top.
    * +├ yow +├ on +└ onqc
    6. +
  6. Create can. Done.
    * +├ yow +├ on +├ onqc +└ can
The result is a flat list: every code sits side by side under *. The highlighted name is where the cursor is.
@@ -229,7 +255,7 @@ region remove can region save ``` -Removing `on` is fine. The region settings in step 3 add it back. Run `region` again, and you +Removing `on` and `can` is fine. The region settings in step 3 add them back. Run `region` again, and you should only see `* F`. ### Step 2: Standard MeshCore Canada settings @@ -257,7 +283,7 @@ already uses, so there is nothing new to look up. The pattern is always the same: ```text -region def |* |* onqc +region def |* |* onqc|* can ``` Examples: @@ -265,7 +291,7 @@ Examples: === "Ottawa" ```text - region def yow|* on|* onqc + region def yow|* on|* onqc|* can region allowf * region default yow region save @@ -274,7 +300,7 @@ Examples: === "Gatineau" ```text - region def yow|* qc|* onqc + region def yow|* qc|* onqc|* can region allowf * region default yow region save @@ -283,7 +309,7 @@ Examples: === "Montréal" ```text - region def yul|* qc|* onqc + region def yul|* qc|* onqc|* can region allowf * region default yul region save @@ -292,14 +318,14 @@ Examples: === "Québec" ```text - region def yqb|* qc|* onqc + region def yqb|* qc|* onqc|* can region allowf * region default yqb region save ```
-
region def …
Carry your city, your province, and onqc.
+
region def …
Carry your city, your province, onqc and can.
region allowf *
Also forward messages with no scope. This is already on by default. We set it anyway so you can see it.
region default yow
This repeater's own adverts use your city's scope, so they stay local.
region save
Keeps the region settings after a reboot. The set commands save by themselves.
@@ -312,6 +338,7 @@ To check, run `region`. For Ottawa you should see: yow F on F onqc F + can F ``` `F` means "flood allowed": the repeater forwards that name. @@ -319,18 +346,18 @@ To check, run `region`. For Ottawa you should see: ### Bridge repeaters A repeater that links two city zones on purpose carries **both** city codes. -For example, a repeater in **Rigaud** sits in the `yul` zone and links Montréal -to the Ottawa zone: +For example, a repeater in **Rigaud** sits in the `yow` zone, on the Québec +side, and links it to the Montréal zone: ```text -region def yul|* yow|* qc|* onqc +region def yow|* yul|* qc|* onqc|* can region allowf * -region default yul +region default yow region save ``` -It forwards Ottawa and Montréal city messages, plus `qc` and `onqc`. Its own -adverts stay in its home zone, `yul`. Only add a neighbouring city when the +It forwards Ottawa and Montréal city messages, plus `qc`, `onqc` and `can`. Its own +adverts stay in its home zone, `yow`. Only add a neighbouring city when the repeater really links the two areas, or city messages will leak further than people expect. @@ -363,9 +390,9 @@ phone the path comes back using **your contact's** default scope.
Phone default yowNever arrives
  1. You, Ottawasends yow
    2. -
  2. Ottawa repeateryow on onqc
    3. -
  3. Montréal repeateryul qc onqc
    4. -
  4. Québec repeateryqb qc onqc
    5. +
  5. Ottawa repeateryow on onqc can
    6. +
  6. Montréal repeateryul qc onqc can
    7. +
  7. Québec repeateryqb qc onqc can
  8. Friend, Québec Citydefault yqb

The Montréal repeater does not carry yow, so the message stops there. Even if it got through, your friend's reply would use yqb and stop on the way back.

@@ -374,9 +401,9 @@ phone the path comes back using **your contact's** default scope.
Phone default onqcDelivered
  1. You, Ottawasends onqc
    2. -
  2. Ottawa repeateryow on onqc
    3. -
  3. Montréal repeateryul qc onqc
    4. -
  4. Québec repeateryqb qc onqc
    5. +
  5. Ottawa repeateryow on onqc can
    6. +
  6. Montréal repeateryul qc onqc can
    7. +
  7. Québec repeateryqb qc onqc can
  8. Friend, Québec Citydefault onqc

Every repeater carries onqc, in both directions. Once the path is found, later DMs go direct and scopes no longer matter.

@@ -393,7 +420,7 @@ Québec. That is why step 2 of the phone setup sets local channels to your city. ## Rollout
    -

  1. Repeaters

    Owners clear old regions, add their three codes and keep * allowed. Nothing breaks for anyone.

    2. +

  2. Repeaters

    Owners clear old regions, add their codes and keep * allowed. Nothing breaks for anyone.

  3. Phones

    Users set their default to onqc and set local channels to their city.

  4. Cutover

    On an agreed date, repeaters run set flood.max.unscoped 3. Messages with no scope then stay within 3 hops, while scoped messages still reach 16.