docs: prepare v4

Author: adrianschubek

docs/docs/configuration/metadata.md

@@ -27,6 +27,10 @@ The `*.dbmeta.json` files are hidden from the user and cannot be viewed.
 If you are looking for the ".dbmeta.**md**" files, see [Readme Rendering](./readme.md).
 :::
 
+:::info Backward Compatibility
+Individual file password protection using metadata files is no longer supported since v4. Use [Folder Passwords](./password.mdx) instead.
+:::
+
 ## Properties
 
 #### Description

docs/docs/configuration/password.mdx

@@ -10,7 +10,11 @@ Folders can be protected with a password using a `.access.json` file.
 Access control applies recursively to all children.
 It is also possible to protect the entire dir-browser instance with a global password.
 
-Both file passwords and a global password can be used at the same time.
+Both folder passwords and a global password can be used at the same time.
+
+:::info Backward Compatibility
+Before v4 individual files could be password protected using `.dbmeta.json`. This is no longer supported.
+:::
 
 ## Folder password
 
@@ -40,7 +44,7 @@ php -r "echo password_hash('foobar', PASSWORD_DEFAULT);"
 ![](password1.png)
 
 
-```json title="/examples/foo   bar/.access.json"
+```json title="/examples/foobar/.access.json"
 {
   "password_hash": "$2y$10$kwS/gp3aGLQ.DqUNhiqiPe1HDBN4mYlyfd06DIC/157L9WAaWngIy",
   "hidden": false,
@@ -50,17 +54,14 @@ php -r "echo password_hash('foobar', PASSWORD_DEFAULT);"
 
 #### Plaintext
 
-```json title=".access.json"
+```json title="/examples/foobar/.access.json"
 {
   "password_raw": "foobar",
   "inherit": true
 }
 ```
 
-:::warning
-Prefer `password_hash` over `password_raw`.
-:::
-
+Prefer `password_hash` over `password_raw` for better security.
 
 ### Access
 
@@ -78,22 +79,22 @@ For programmatic access, send the key via the `X-Key` header:
 
 `X-Key: foobar`
 
-#### POST request
-
-Or as part of a POST request
-
 ```
-curl -X POST https://dir-demo.adriansoftware.de/examples/foo%20%20%20bar/ -d "key=foobar"
+ curl -H "X-Key: foobar" https://dir-demo.adriansoftware.de/examples/foo%20%20%20bar/
+```
 
 :::info
 Legacy support: `?key=...` is still accepted, but dir-browser will redirect to a clean URL after setting the cookie.
+
+```
+curl -X POST https://dir-demo.adriansoftware.de/examples/foo%20%20%20bar/ -d "key=foobar"
+```
 :::
 
 ### Inheritance
 
 When evaluating access, dir-browser checks the current folder `.access.json` and all parent folders.
 Parent configs only apply to subfolders when `inherit: true`. Subfolder configs override parent configs.
-```
 
 ## Global password
 
@@ -106,7 +107,7 @@ import EnvConfig from '@site/src/components/EnvConfig';
 <EnvConfig name="PASSWORD_USER|PASSWORD_RAW|PASSWORD_HASH" init="<empty>|<empty>|<empty>" values="<string>|<string>|<hash>" desc="Username|Plaintext password|Hash of a password. See definition above." versions="3.3|3.3|3.3"/>
 
 :::warning
-`PASSWORD_USER` and either `PASSWORD_RAW` or `PASSWORD_HASH` is mandatory to specify.
+If `PASSWORD_USER` is set then either `PASSWORD_RAW` or `PASSWORD_HASH` is required.
 :::
 
 {/* :::info

docs/docs/intro.md

@@ -2,9 +2,9 @@
 sidebar_position: 1
 ---
 
-# 👋 Welcome
+# dir-browser
 
-![](/img/p1.png)
+<!-- ![](/img/p1.png) -->
 <!-- ![](/img/dir-browser.png) -->
 
 ## Demo

docs/docs/v3.md

@@ -124,7 +124,7 @@ const config = {
       announcementBar: {
         id: 'abar',
         content:
-          '🔥 dir-browser <a href="/v3/intro">v3.0</a> released with tons of new features and fresh UI 🔥',
+          '🔥 dir-browser <a href="/v4/intro">v4.0</a> released with support for password-protected folders 🔐',
         backgroundColor: '#fafbfc',
         textColor: '#091E42',
         isCloseable: true,

docs/docusaurus.config.js

@@ -47,7 +47,7 @@ function HomepageHeader() {
               </Link>
               <Link
                 className="button button--secondary button--lg"
-                to="/v3/intro">
+                to="/v4/intro">
                 Get started 🚀
               </Link>
             </div>