Jump to content
Gov  ·  Market  ·  Community  ·  Policies  ·  Funding  ·  Open Calls  ·  Get started

WikiDeal:Naming conventions: Difference between revisions

From WikiDeal
Create Naming Conventions page — Q1 resolved (5 languages), Q2/Q3 TBD
 
Add missing intros per Theo's 20s rule
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{KidsIntro|This page explains how to name things on WikiDeal wiki. It uses different language codes like En/ for English and Fr/ for French. Everyone writes in English first, then translates later.}}
{{ExpertIntro|We are heading towards a scalable multilingual wiki architecture that prioritizes English-first content stability during prototype phases, with batch translations triggered at mature version milestones rather than continuous per-page translation. This hypothesis proposes that namespace segregation between content pages (En/), operational pages (WikiDeal:), and market-specific domains (Market:, Contract:) mitigates localization debt while enabling progressive language expansion as communities mature.}}
{{DISPLAYTITLE:Naming Conventions}}
{{DISPLAYTITLE:Naming Conventions}}
== WikiDeal Naming Conventions ==
== WikiDeal: Naming Conventions ==


This page defines the URL and namespace conventions for all pages on this wiki.
This page defines the URL and namespace conventions for all pages on this wiki.
WikiDeal is designed to be at least as rich and complex as Wikipedia, with a strong community and full multilingual support.
WikiDeal is designed to be at least as rich and complex as Wikipedia, with a strong community and full multilingual support.


'''Status:''' Work in progress some decisions marked <code>TBD</code> are pending final confirmation.
'''Status:''' Work in progress, some decisions marked <code>TBD</code> are pending final confirmation.


---
---
Line 11: Line 14:
== 1. Languages ==
== 1. Languages ==


WikiDeal supports 5 official languages. Each language has its own prefix:
WikiDeal supports 5 official languages chosen for the founding phase. Each language has its own prefix:


{| class="wikitable"
{| class="wikitable"
! Prefix !! Language !! Status
! Prefix !! Language !! Prototype status
|-
|-
| <code>En/</code> || English || ✅ Primary — active
| <code>En/</code> || English || ✅ Primary, exclusive during prototype
|-
|-
| <code>Fr/</code> || French || 🔜 Planned
| <code>Fr/</code> || French || 🔜 Translated at first mature milestone
|-
|-
| <code>Es/</code> || Spanish || 🔜 Planned
| <code>Es/</code> || Spanish || 🔜 Translated at first mature milestone
|-
|-
| <code>Pt/</code> || Portuguese || 🔜 Planned
| <code>Pt/</code> || Portuguese || 🔜 Translated at first mature milestone
|-
|-
| <code>It/</code> || Italian || 🔜 Planned
| <code>It/</code> || Italian || 🔜 Translated at first mature milestone
|}
|}


* All new pages are created in English first.
These 5 languages reflect the languages mastered by the WikiDeal founder. German is intentionally excluded from the initial scope. Additional languages will be added progressively as active communities form on the platform.
* Translations are added as subpages with the appropriate language prefix.
 
* German is intentionally excluded from the initial scope.
=== Language policy during the prototype phase ===
 
'''English is the absolute reference language.''' All pages are written and approved in English first. Translations always follow, never precede.
 
'''Phase 1, Prototype (current):''' English only. The <code>En/</code> prefix is applied to all pages from the start, even when English is the sole language. This prepares the multilingual structure with zero future debt.
 
'''Phase 2, At each mature version milestone:''' When a set of pages reaches a stable, approved state, a batch translation is triggered across all 4 other languages simultaneously. Translations happen by version lot, not page by page.
 
'''Phase 3, Progressive opening:''' Additional language prefixes are added when active communities request them and are ready to maintain them.
 
''Rationale: Prototype content is unstable by definition. Translating during active drafting wastes effort. Lock English first, then translate.''


---
---
Line 37: Line 50:
WikiDeal uses a combination of MediaWiki namespaces and language prefixes.
WikiDeal uses a combination of MediaWiki namespaces and language prefixes.


=== 2.1 Content pages (encyclopedic knowledge) ===
=== 2.1: Content pages (encyclopedic knowledge) ===


Pages that explain WikiDeal's concepts, mechanisms, and frameworks written for users and the public.
Pages that explain WikiDeal's concepts, mechanisms, and frameworks, written for users and the public.


* '''Pattern:''' <code>En/Page_Name</code>
* '''Pattern:''' <code>En/Page_Name</code>
Line 45: Line 58:
* '''Translated:''' <code>Fr/Arbitrage_Simplifié</code>, <code>Es/Arbitraje_Simplificado</code>, etc.
* '''Translated:''' <code>Fr/Arbitrage_Simplifié</code>, <code>Es/Arbitraje_Simplificado</code>, etc.


'''Decision point (TBD):''' Are Core pages (Governance, Arbitration, Credits…) written primarily for end-users, or for editors/admins? This determines whether they belong in <code>En/</code> or <code>WikiDeal:</code>. → ''Pending answer from Théo Bondolfi.''
'''Decision point (TBD):''' Are Core pages (Governance, Arbitration, Credits…) written primarily for end-users, or for editors/admins? This determines whether they belong in <code>En/</code> or <code>WikiDeal:</code>. → ''Pending answer from the WikiDeal founder.''


=== 2.2 Wiki operational pages (internal rules) ===
=== 2.2: Wiki operational pages (internal rules) ===


Pages that govern how this wiki operates for editors and administrators.
Pages that govern how this wiki operates, for editors and administrators.


* '''Namespace:''' <code>WikiDeal:</code>
* '''Namespace:''' <code>WikiDeal:</code>
* '''Examples:''' <code>[[WikiDeal:Naming_conventions]]</code>, <code>[[WikiDeal:Disclaimer_conventions]]</code>, <code>[[WikiDeal:Editing_policy]]</code>
* '''Examples:''' <code>[[WikiDeal:Naming_conventions]]</code>, <code>[[WikiDeal:Disclaimer_conventions]]</code>, <code>[[WikiDeal:Editing_policy]]</code>
* '''Note:''' These pages are NOT translated they are operational documents in English only.
* '''Note:''' These pages are NOT translated: they are operational documents in English only.


=== 2.3 Marketplace & use cases ===
=== 2.3: Marketplace & use cases ===


Pages describing specific sectors, use cases, and market portals.
Pages describing specific sectors, use cases, and market portals.
Line 62: Line 75:
* '''Examples:''' <code>[[Market:Babysitting]]</code>, <code>[[Market:Street_Fundraising]]</code>, <code>[[Market:Real_Estate]]</code>
* '''Examples:''' <code>[[Market:Babysitting]]</code>, <code>[[Market:Street_Fundraising]]</code>, <code>[[Market:Real_Estate]]</code>


=== 2.4 Contracts ===
=== 2.4: Contracts ===


Contract templates the core transactional documents of the platform.
Contract templates, the core transactional documents of the platform.


* '''Namespace:''' <code>Contract:</code> (to be created)
* '''Namespace:''' <code>Contract:</code> (to be created)
* '''Examples:''' <code>Contract:Babysitting_Base</code>, <code>Contract:Pet_Sitting</code>
* '''Examples:''' <code>Contract:Babysitting_Base</code>, <code>Contract:Pet_Sitting</code>
* '''Decision point (TBD):''' Are contracts centralized (<code>Contract:</code>) or owned by User Groups (<code>UserGroup:Babysitting/Contract_Base</code>)? → ''Pending answer from Théo Bondolfi.''
* '''Decision point (TBD):''' Are contracts centralized (<code>Contract:</code>) or owned by User Groups (<code>UserGroup:Babysitting/Contract_Base</code>)? → ''Pending answer from the WikiDeal founder.''


=== 2.5 Community & User Groups ===
=== 2.5: Community & User Groups ===


* '''Namespace:''' <code>User_group:</code> (exists)
* '''Namespace:''' <code>User_group:</code> (exists)
* '''Examples:''' <code>[[User_group:Home]]</code>
* '''Examples:''' <code>[[User_group:Home]]</code>


=== 2.6 Portals ===
=== 2.6: Portals ===


* '''Namespace:''' <code>Portal:</code> (exists)
* '''Namespace:''' <code>Portal:</code> (exists)
Line 82: Line 95:
---
---


== 3. The Test Which namespace? ==
== 3. The Test: Which namespace? ==


When creating a new page, ask:
When creating a new page, ask:
Line 113: Line 126:
== 5. Open decisions ==
== 5. Open decisions ==


The following points are confirmed by Théo Bondolfi and documented here as they are resolved:
The following points are confirmed by the WikiDeal founder and documented here as they are resolved:


{| class="wikitable"
{| class="wikitable"
! # !! Question !! Status !! Decision
! # !! Question !! Status !! Decision
|-
|-
| Q1 || Official languages || ✅ Decided || En, Fr, Es, Pt, It (no German)
| Q1 || Official languages || ✅ Decided || En (prototype), + Fr, Es, Pt, It at each mature milestone. No German.
|-
|-
| Q2 || Core pages: for users or admins? || 🔴 TBD ||
| Q2 || Core pages: for users or admins? || 🔴 TBD || ''(pending)''
|-
|-
| Q3 || Contracts: centralized or per User Group? || 🔴 TBD ||
| Q3 || Contracts: centralized or per User Group? || 🔴 TBD || ''(pending)''
|}
|}



Latest revision as of 03:29, 9 August 2026

💡 In simple words: This page explains how to name things on WikiDeal wiki. It uses different language codes like En/ for English and Fr/ for French. Everyone writes in English first, then translates later.

🎯 In 20 seconds (scientific summary): We are heading towards a scalable multilingual wiki architecture that prioritizes English-first content stability during prototype phases, with batch translations triggered at mature version milestones rather than continuous per-page translation. This hypothesis proposes that namespace segregation between content pages (En/), operational pages (WikiDeal:), and market-specific domains (Market:, Contract:) mitigates localization debt while enabling progressive language expansion as communities mature.


WikiDeal: Naming Conventions

This page defines the URL and namespace conventions for all pages on this wiki. WikiDeal is designed to be at least as rich and complex as Wikipedia, with a strong community and full multilingual support.

Status: Work in progress, some decisions marked TBD are pending final confirmation.

---

1. Languages

WikiDeal supports 5 official languages chosen for the founding phase. Each language has its own prefix:

Prefix Language Prototype status
En/ English ✅ Primary, exclusive during prototype
Fr/ French 🔜 Translated at first mature milestone
Es/ Spanish 🔜 Translated at first mature milestone
Pt/ Portuguese 🔜 Translated at first mature milestone
It/ Italian 🔜 Translated at first mature milestone

These 5 languages reflect the languages mastered by the WikiDeal founder. German is intentionally excluded from the initial scope. Additional languages will be added progressively as active communities form on the platform.

Language policy during the prototype phase

English is the absolute reference language. All pages are written and approved in English first. Translations always follow, never precede.

Phase 1, Prototype (current): English only. The En/ prefix is applied to all pages from the start, even when English is the sole language. This prepares the multilingual structure with zero future debt.

Phase 2, At each mature version milestone: When a set of pages reaches a stable, approved state, a batch translation is triggered across all 4 other languages simultaneously. Translations happen by version lot, not page by page.

Phase 3, Progressive opening: Additional language prefixes are added when active communities request them and are ready to maintain them.

Rationale: Prototype content is unstable by definition. Translating during active drafting wastes effort. Lock English first, then translate.

---

2. Namespace Structure

WikiDeal uses a combination of MediaWiki namespaces and language prefixes.

2.1: Content pages (encyclopedic knowledge)

Pages that explain WikiDeal's concepts, mechanisms, and frameworks, written for users and the public.

Decision point (TBD): Are Core pages (Governance, Arbitration, Credits…) written primarily for end-users, or for editors/admins? This determines whether they belong in En/ or WikiDeal:. → Pending answer from the WikiDeal founder.

2.2: Wiki operational pages (internal rules)

Pages that govern how this wiki operates, for editors and administrators.

2.3: Marketplace & use cases

Pages describing specific sectors, use cases, and market portals.

2.4: Contracts

Contract templates, the core transactional documents of the platform.

  • Namespace: Contract: (to be created)
  • Examples: Contract:Babysitting_Base, Contract:Pet_Sitting
  • Decision point (TBD): Are contracts centralized (Contract:) or owned by User Groups (UserGroup:Babysitting/Contract_Base)? → Pending answer from the WikiDeal founder.

2.5: Community & User Groups

2.6: Portals

---

3. The Test: Which namespace?

When creating a new page, ask:

Question Answer → Namespace
Is it explaining a WikiDeal concept to a user or the public? En/
Is it an operational rule for wiki editors/admins? WikiDeal:
Is it a sector or marketplace use case? Market:
Is it a contract template? Contract:
Is it a community or user group space? User_group:

---

4. Page naming rules

  • Use underscores for spaces: En/Simplified_Arbitration (not En/Simplified Arbitration)
  • Use title case for page names: En/Rings_of_Trust
  • No abbreviations unless officially defined in the Glossary
  • Sub-pages use /: En/Babysitting/Compensation_Rules

---

5. Open decisions

The following points are confirmed by the WikiDeal founder and documented here as they are resolved:

# Question Status Decision
Q1 Official languages ✅ Decided En (prototype), + Fr, Es, Pt, It at each mature milestone. No German.
Q2 Core pages: for users or admins? 🔴 TBD (pending)
Q3 Contracts: centralized or per User Group? 🔴 TBD (pending)

---