add old site redirects

WebFreak001 · WebFreak001 · commit ae7611706d81 · 2023-09-06T13:13:01.000+02:00
diff --git a/docs/dub-guide/building.md b/docs/dub-guide/building.md
@@ -7,3 +7,41 @@
     Tracking issue: <https://github.com/WebFreak001/dub-docs-v2/issues/4>
 
 For the command to build your application, see [`dub build`](../cli-reference/dub-build.md) and [`dub run`](../cli-reference/dub-run.md)
+
+```
+dub build
+```
+
+If you have multiple [configurations](../dub-reference/configurations.md) defined in your recipe, you might need to specify which configuration to build:
+
+```
+dub build --config=server
+```
+
+Or if you want to build a [sub-package](../dub-reference/subpackages.md), you can do so from the root package as well:
+
+```
+dub build :mysubpackage
+```
+
+## Running
+
+For all of the samples above, you can swap out `dub build` with [`dub run`](../cli-reference/dub-run.md) to both **build and run** your application in a single command line call.
+
+This only works for packages that have an `executable` [target type](../dub-reference/target_types.md), which may be [automatically inferred](../dub-reference/configurations.md#default-configuration) by `autodetect`.
+
+```
+dub run
+dub run --config=server
+dub run :mysubpackage
+```
+
+### Passing arguments to the application
+
+For any of the above `dub run` calls you can also specify your own command line arguments by separating DUB's arguments from your own using `--` between them:
+
+```
+dub run -- my app args
+dub run --config=server -- --config=ignored-by-dub
+dub run :mysubpackage -- works universally
+```
diff --git a/docs/dub-guide/recipe.md b/docs/dub-guide/recipe.md
@@ -47,9 +47,6 @@ In all documents in the documentation you can switch between dub.json and dub.sd
 
 Please keep the description concise (not more than 100 characters) and avoid including unspecific information such as the fact that the package is written in D. The same goes for the package name - since all DUB packages are written in D, it's usually better to avoid mentioning D explicitly, unless the package is for example a high-level wrapper around a C/C++ library.
 
-!!! hint "Just an excerpt"
-    These are just the boiled down documentation of the available fields, refer to the [recipe](../dub-reference/recipe.md) page in the DUB reference for details to any given field.
-
 ## Package settings
 
 Package settings (top-level settings) such as name, description, homepage,
@@ -98,6 +95,9 @@ See also: [Platform specifications](../dub-reference/platform_specifications.md)
 
 ## Build settings
 
+!!! hint "Just an excerpt"
+    These are just the boiled down documentation of the available fields, refer to the [recipe](../dub-reference/recipe.md) page in the DUB reference for details to any given field.
+
 Build settings influence the command line options passed to the compiler and linker. All settings are optional.
 
 === "dub.sdl"
diff --git a/docs/dub-reference/dependencies.md b/docs/dub-reference/dependencies.md
@@ -40,15 +40,25 @@ See [version specifiers](./build_settings.md#version-specifiers).
 ### `version` + `optional` + `default=false`
 ### `path`
 
-Note: this is best used in sub-packages, avoid going outside of repository bounds for public projects.
+!!! note
+
+    For public projects, avoid leaving your package root, so that users can build your package without needing to manage external dependencies.
+
+Inside sub-packages you can refer to the parent package using `path=".."` (or elsewhere, depending on folder structure), to avoid DUB accidentally looking up a different package location whenever you run DUB from inside the sub-package folder.
 
 ### `repository`
 #### Git repositories
 
 ### `dflags`
 ## `dub.selections.json`
 ## `dub add-path`
+
+CLI docs: [`dub add-path`](../cli-reference/dub-add-path.md)
+
 ## `dub add-local`
+
+CLI docs: [`dub add-local`](../cli-reference/dub-add-local.md)
+
 ## Dependency/version resolution
 ## Per-configuration dependencies
 
@@ -60,4 +70,39 @@ Note: this is best used in sub-packages, avoid going outside of repository bound
 
     Tracking issue: <https://github.com/WebFreak001/dub-docs-v2/issues/2>
 
-Upstream documentation: <https://dub.pm/advanced_usage>
+Projects can have additional special dependencies for specific configurations.
+
+```json
+"configurations": [
+	{
+		"name": "myconfig",
+		"dependencies": {
+			"mydep": { "version": "*" }
+		}
+	}
+]
+```
+
+DUB provides version identifier of dependencies for conditional compilation with [version conditions](https://dlang.org/spec/version.html#version). `Have_<dependency>` version identifier can be used for conditional compilation.
+
+!!! note
+
+    Special characters other than identifier characters (`[a-z, A-Z, 0-9, _]`) in dependency name are replaced with an underscore (`_`) character in their version identifier.
+
+```d
+version (Have_mydep) {
+    // dependency "mydep" is being included
+    import mydep;
+}
+version (Have_vibe_d_http) {
+    // dependency "vibe-d:http" is being included
+}
+```
+
+Note that your package has to somehow depend on the package for it to get these `Have_*` version identifiers. If you want to query for it without pulling in a new dependency, use optional dependencies:
+
+```json
+"dependencies": {
+    "vibe-d:http": { "optional": true, "version": "*" }
+}
+```
diff --git a/docs/dub-reference/subpackages.md b/docs/dub-reference/subpackages.md
@@ -6,4 +6,7 @@
 
     Tracking issue: <https://github.com/WebFreak001/dub-docs-v2/issues/20>
 
-Upstream documentation: <https://dub.pm/advanced_usage>
+For adding sub-packages from the registry as a dependency, execute `dub add <packagename>:<subpackage>`
+
+If you need to compile a sub-package only, use `dub build :<subpackage>`
+
diff --git a/docs/link-upgrades.md b/docs/link-upgrades.md
@@ -0,0 +1,120 @@
+---
+hide:
+  - navigation
+  - toc
+search:
+  exclude: true
+---
+
+
+# Old Links
+
+<a id="own-projects"></a>
+## Starting a new project
+
+A tutorial how to create projects is available in the [Getting Started / First Steps](./getting-started/first-steps.md) section.
+
+<a id="adding-deps"></a>
+## Adding a dependency
+
+This was moved to [Getting Started / First Steps](./getting-started/first-steps.md#adding-a-dependency)
+
+<a id="foreign-projects"></a>
+## Building a third-party project
+
+This was moved to [Getting Started / First Steps](./getting-started/first-steps.md#building-a-third-party-project)
+
+<a id="app-arguments"></a>
+## Pass commandline arguments to application
+
+This was moved to [DUB Guide / Building](./dub-guide/building.md#passing-arguments-to-the-application)
+
+<a id="single-file"></a>
+## Single-file packages
+
+This was moved to [DUB Guide / Single-file packages](./dub-guide/single.md)
+
+<a id="local-deps"></a>
+## Using dependencies not published on the registry
+
+This was moved to [DUB Reference / Dependencies](./dub-reference/dependencies.md)
+
+<a id="subpkg"></a>
+## Managing subpackages
+
+This was moved to [DUB Reference / Sub-Packages](./dub-reference/subpackages.md)
+
+<a id="have-version"></a>
+## Conditional compilation according to dependency presence
+
+This was moved to [DUB Reference / Dependencies / Have_xyz](./dub-reference/dependencies.md#have_xyz)
+
+<a id="advanced-usage"></a>
+## Advanced usage
+
+This has been split up into [DUB Guide](./dub-guide/recipe.md) for overview about features and [DUB Reference](./dub-reference/recipe.md) for detailed information about each functionality.
+
+<a id="standard-settings"></a>
+## Package settings (previously called: Global settings)
+
+This has been moved into [DUB Reference / Package Settings](./dub-reference/package_settings.md)
+
+<a id="build-settings"></a>
+## Build settings
+
+This has been moved into [DUB Reference / Build Settings](./dub-reference/build_settings.md)
+
+<a id="configurations"></a>
+## Configurations
+
+This has been moved into [DUB Reference / Configurations](./dub-reference/configurations.md)
+
+<a id="build-types"></a>
+## Build types
+
+This has been moved into [DUB Reference / Build types](./dub-reference/buildtypes.md)
+
+<a id="toolchain-requirements"></a>
+## Toolchain requirements
+
+This has been moved into [DUB Reference / Package Settings / `toolchainRequirements`](./dub-reference/package_settings.md#toolchainrequirements)
+
+<a id="project-creation"></a>
+## Creating the project (publishing)
+
+This has been moved into [DUB Guide / Publishing](./dub-guide/publishing.md)
+
+<a id="register"></a>
+## Registering with the registry (publishing)
+
+This has been moved into [DUB Guide / Publishing](./dub-guide/publishing.md#registering-with-the-registry)
+
+<a id="versions"></a>
+## Version tags (publishing)
+
+This has been moved into [DUB Guide / Publishing](./dub-guide/publishing.md#version-tags)
+
+<a id="private-repositories"></a>
+## Private repositories (publishing)
+
+This has been moved into [DUB Guide / Publishing](./dub-guide/publishing.md#private-repositories)
+
+<a id="package-scoring"></a>
+## Package Scoring
+
+This has been moved into [DUB Guide / Publishing](./dub-guide/publishing.md#package-scoring)
+
+<a id="publishing-packages"></a>
+## Publishing packages
+
+This has been moved into [DUB Guide / Publishing](./dub-guide/publishing.md)
+
+<a id="help-with-dub"></a>
+## Help with DUB"s development
+
+This has been moved into [DUB Guide / Contributing](./dub-guide/contributing.md)
+
+<a id="development-focus"></a>
+## Development focus
+
+This page has been dropped and can be considered superseded by [DUB Guide / Contributing](./dub-guide/contributing.md)
diff --git a/docs/package-format-upgrades.md b/docs/package-format-upgrades.md
@@ -0,0 +1,22 @@
+---
+hide:
+  - navigation
+  - toc
+search:
+  exclude: true
+---
+
+
+# Migrate to new Recipe Documentation
+
+The package format documentation has been split up into multiple pages that each more precisely document each individual setting with examples.
+
+- General layout: [DUB Reference / Recipe](./dub-reference/recipe.md)
+- Package settings: [DUB Reference / Package settings](./dub-reference/package_settings.md)
+- **Build settings:** [DUB Reference / Build Settings](./dub-reference/build_settings.md)
+- Configurations: [DUB Reference / Configurations](./dub-reference/configurations.md)
+- Build types: [DUB Reference / Build Types](./dub-reference/buildtypes.md)
+
+## Introducing **DUB Guide**
+
+If you want to learn about the concepts first before diving into the detailed documentation, take a look at the [DUB Guide](./dub-guide/recipe.md) for a more gentle introduction into the package recipes, as well as tutorials that are made by use-case that will link to the reference page.
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -39,6 +39,17 @@ plugins:
   - search
   - git-revision-date-localized:
       enable_creation_date: true
+  - redirects:
+      redirect_maps:
+        'getting_started.md': 'link-upgrades.md'
+        'advanced_usage.md': 'link-upgrades.md'
+        'develop.md': 'dub-guide/contributing.md'
+        'package-suppliers.md': 'dub-reference/suppliers.md'
+        'publish.md': 'dub-guide/publishing.md'
+        'settings.md': 'dub-reference/settings.md'
+        'commandline.md': 'cli-reference/dub.md'
+        'package-format-json.md': 'package-format-upgrades.md'
+        'package-format-sdl.md': 'package-format-upgrades.md'
 
 markdown_extensions:
   - admonition
diff --git a/requirements.txt b/requirements.txt
@@ -1,3 +1,4 @@
 mkdocs~=1.3.1
 mkdocs-material~=8.4.0
 mkdocs-git-revision-date-localized-plugin~=1.1.0
+mkdocs-redirects~=1.2.1
