Sandbox/Version demo/1.0: Difference between revisions

Content deleted Content added

VisualWikitext

Inline

@@ Line 2: / Line 2: @@
 |type=guide
 |domain=platform
-|title=Version Demo (v1.0 — frozen)
+|title=Version Demo (v1.0)
 |order=999
 |introduced=1.0
@@ Line 10: / Line 10: @@
 __NOINDEX__
-This is a '''frozen snapshot''' demonstrating the wiki's copy-on-write versioning system. It is not real documentation.
+{{Warning|1=This is a '''sandbox demonstration''' of the wiki's copy-on-write versioning system. It represents a fictional "v1.0" snapshot to show how frozen forks behave. See [[Sandbox/Version demo]] for the full comparison.}}
-== How versioning worked (old) ==
+== Notification system (v1.0) ==
+In version 1.0, notifications were minimal:
-In the original design, every page was duplicated per release:
+* Single channel: '''email only'''
-{| class="wikitable"
+* No user preferences — all users received all notifications
-! Approach !! Cost
+* Plain text, no templates
-|-
+* Sent synchronously during request handling (blocked the UI)
-| Full copy per version || O(n × versions) pages
-|-
-| Manual sync of shared content || High editorial burden
-|}
+== Configuration ==
-{{Warning|1=This page exists solely to demonstrate the frozen-page banner and version-switcher pills. It contains no real information.}}
+<syntaxhighlight lang="text">
-== See also ==
+NOTIFICATIONS_ENABLED = true
+SMTP_HOST = mail.example.com
+</syntaxhighlight>
+That was it. Two environment variables.
-* [[Sandbox/Version demo]] — the "current" (latest) version of this demo page
+== Known limitations ==
+* No delivery tracking
+* No retry on failure
+* No opt-out mechanism
+* High latency on actions that triggered emails
+These limitations were addressed in [[Sandbox/Version demo/2.0|version 2.0]].
+== What you're observing right now ==
+This frozen page demonstrates several things:
+# '''The blue banner above''' — auto-generated by <code><nowiki>{{Version switcher}}</nowiki></code> when <code>status=frozen</code>. It links you back to the canonical (latest) page.
+# '''The metadata badges''' — show "CARE 1.0 – 2.0", meaning this content was valid from 1.0 until it was superseded in 2.0.
+# '''The global dropdown''' (top of the badge strip) — lets you jump to any version. Try selecting "4.0 (latest)" to return to the canonical page.
+# '''<code>__NOINDEX__</code>''' — this page is invisible to search engines. Only the canonical page ranks.
+In Docusaurus, this same "old version" content would be a full copy of the '''entire''' documentation tree — even the 95% of pages that didn't change between 1.0 and 2.0. Here, only this one page exists as a fork because only this page's content diverged.
 [[Category:Sandbox]]