View source for WikiDeal:Naming conventions

{{DISPLAYTITLE:Naming Conventions}}
== 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 <code>TBD</code> are pending final confirmation.

---

== 1. Languages ==

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

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

These 5 languages reflect the languages mastered by the WikiDeal founder (Théo Bondolfi). 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 <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.''

---

== 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.

* '''Pattern:''' <code>En/Page_Name</code>
* '''Examples:''' <code>[[En/Simplified_Arbitration]]</code>, <code>[[En/Credits_Explained]]</code>, <code>[[En/Rings_of_Trust]]</code>
* '''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.''

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

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

* '''Namespace:''' <code>WikiDeal:</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.

=== 2.3 — Marketplace & use cases ===

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

* '''Namespace:''' <code>Market:</code>
* '''Examples:''' <code>[[Market:Babysitting]]</code>, <code>[[Market:Street_Fundraising]]</code>, <code>[[Market:Real_Estate]]</code>

=== 2.4 — Contracts ===

Contract templates — the core transactional documents of the platform.

* '''Namespace:''' <code>Contract:</code> (to be created)
* '''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.''

=== 2.5 — Community & User Groups ===

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

=== 2.6 — Portals ===

* '''Namespace:''' <code>Portal:</code> (exists)
* '''Examples:''' <code>[[Portal:AI_Assistance]]</code>

---

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

When creating a new page, ask:

{| class="wikitable" style="width:100%;"
! Question !! Answer → Namespace
|-
| Is it explaining a WikiDeal concept to a user or the public? || → <code>En/</code>
|-
| Is it an operational rule for wiki editors/admins? || → <code>WikiDeal:</code>
|-
| Is it a sector or marketplace use case? || → <code>Market:</code>
|-
| Is it a contract template? || → <code>Contract:</code>
|-
| Is it a community or user group space? || → <code>User_group:</code>
|}

---

== 4. Page naming rules ==

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

---

== 5. Open decisions ==

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

{| class="wikitable"
! # !! 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 || —
|-
| Q3 || Contracts: centralized or per User Group? || 🔴 TBD || —
|}

---

[[Category:WikiDeal conventions]]