docpensieve 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "docpensieve",
3
- "version": "0.4.0",
3
+ "version": "0.4.1",
4
4
  "description": "DocPensieve command-line interface (init, build, check, dev, serve)",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -24,10 +24,10 @@
24
24
  "types"
25
25
  ],
26
26
  "dependencies": {
27
- "@docpensieve/components": "0.4.0",
28
- "@docpensieve/core": "0.4.0",
29
- "@docpensieve/shared": "0.4.0",
30
- "@docpensieve/theme": "0.4.0",
27
+ "@docpensieve/components": "0.4.1",
28
+ "@docpensieve/core": "0.4.1",
29
+ "@docpensieve/shared": "0.4.1",
30
+ "@docpensieve/theme": "0.4.1",
31
31
  "chalk": "^6.0.0",
32
32
  "chokidar": "^5.0.0",
33
33
  "commander": "^15.0.0"
@@ -56,6 +56,23 @@ Nothing already published moves, which is the point: a link shared last year
56
56
  still leads where it led. The translation lives **inside** the version, so a
57
57
  version is still one folder, one orphan branch, one stylesheet.
58
58
 
59
+ ## Moving from one version to another
60
+
61
+ The version switcher, the notice on a beta or an archive, and the links of the
62
+ header lead to another version — in the reader's language when that version
63
+ has the page in it, in the language of the site when it does not. A French
64
+ reader of the beta who follows its notice lands on the French pages of the
65
+ current version; a version never translated opens in the language it was
66
+ written in, rather than on an address that leads nowhere.
67
+
68
+ The links you write in a page stay in their language by themselves, as long as
69
+ they are written from the page. A link that starts from the root of the
70
+ version — `/guide/install/` — leads to the French page from a French page. A
71
+ relative link climbs from the folder of its file, and the folders of a
72
+ translation mirror those of the site language: write it as the twin page
73
+ writes it. One level too many and it leaves the language, which `check` cannot
74
+ see — the English page it lands on exists.
75
+
59
76
  ## A page nobody translated
60
77
 
61
78
  It does not exist in that language. It is absent from the menu of that