From b6f9b1deacd6340ce29dd4114e858e93e0b938a0 Mon Sep 17 00:00:00 2001 From: CamWight <91156642+CamWight@users.noreply.github.com> Date: Sat, 17 Oct 2026 12:26:28 +0100 Subject: [PATCH] Pages links point at docs.solidcraft.io: Flatpak repository, help and troubleshooting (#1922) Thanks @CamWight. --- .github/release-notes.md | 14 +++++++++----- CONTRIBUTING.md | 2 +- apps/solidcraft/src/startup.rs | 2 +- .../ai.storyteller.solidcraft.metainfo.xml.in | 4 ++-- assets/platforms/windows/solidcraft.wxs | 2 +- crates/ui-egui/src/help.rs | 2 +- docs/book/src/guide/getting-started.md | 7 ++++++- docs/compatibility.md | 7 +++++-- packaging/linux/nfpm.yaml | 2 +- packaging/linux/snap/snapcraft.yaml | 2 +- 10 files changed, 28 insertions(+), 16 deletions(-) diff --git a/.github/release-notes.md b/.github/release-notes.md index 3a5920b6..05f7fd0f 100644 --- a/.github/release-notes.md +++ b/.github/release-notes.md @@ -1,9 +1,9 @@ SolidCraft is open-source parametric 3D CAD in Rust: sketch, constrain, extrude, and change a -parameter to watch the timeline rebuild. [Documentation](https://bherbruck.github.io/solidcraft/) -· [try it in the browser](https://bherbruck.github.io/solidcraft/app/) · +parameter to watch the timeline rebuild. [Documentation](https://docs.solidcraft.io/) +· [try it in the browser](https://solidcraft.io/app) · [contributing](https://github.com/bherbruck/solidcraft/blob/main/CONTRIBUTING.md) · [issues](https://github.com/bherbruck/solidcraft/issues). AI agents can model with it over MCP: -`solidcraft-cli mcp` ([how](https://bherbruck.github.io/solidcraft/guide/mcp.html)). +`solidcraft-cli mcp` ([how](https://docs.solidcraft.io/guide/mcp.html)). **What's new** in SolidCraft {version} is listed below, and the [ROADMAP](https://github.com/bherbruck/solidcraft/blob/main/ROADMAP.md#known-limitations) lists @@ -41,16 +41,20 @@ installing SolidCraft; keep both remotes in the same user installation: ```sh flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo -flatpak remote-add --user --if-not-exists solidcraft https://bherbruck.github.io/solidcraft/flatpak/solidcraft.flatpakrepo +flatpak remote-add --user --if-not-exists solidcraft https://docs.solidcraft.io/flatpak/solidcraft.flatpakrepo flatpak install --user solidcraft ai.storyteller.solidcraft flatpak run ai.storyteller.solidcraft ``` +A remote added from the old `bherbruck.github.io` address no longer finds updates: run +`flatpak remote-modify --user --url=https://docs.solidcraft.io/flatpak/repo/ solidcraft`, then +`flatpak update --user`. + Flatpak installs from 0.7 or earlier use the old ID `ai.storyteller.solvecraft`: `flatpak update --user` offers to replace it with `ai.storyteller.solidcraft`, and settings move along. Single-file `.flatpak` bundles include the runtime repository address; missing runtimes -still need an internet connection. [Linux installation details](https://bherbruck.github.io/solidcraft/guide/getting-started.html#linux-flatpak). +still need an internet connection. [Linux installation details](https://docs.solidcraft.io/guide/getting-started.html#linux-flatpak). The builds aren't signed yet. On macOS, right-click `SolidCraft.app` in Applications and choose **Open** the first time (or run `xattr -dr com.apple.quarantine /Applications/SolidCraft.app`). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 5bbeeb20..39e63887 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -300,7 +300,7 @@ long as the change meets the rules above. ## Where help is wanted most -**Kernel speed (slow fillets, booleans, STEP):** please don't rewrite the current kernel code for speed; it is being replaced by [solidcore](https://github.com/bherbruck/solidcore) ([progress](https://bherbruck.github.io/solidcore/)). Report slow cases with a file under the `kernel-perf` label, and put kernel effort into solidcore instead. See [#1597](https://github.com/tangency-labs/solidcraft/issues/1597). +**Kernel speed (slow fillets, booleans, STEP):** please don't rewrite the current kernel code for speed; it is being replaced by [solidcore](https://github.com/bherbruck/solidcore) ([progress](https://tangency-labs.github.io/solidcore/)). Report slow cases with a file under the `kernel-perf` label, and put kernel effort into solidcore instead. See [#1597](https://github.com/tangency-labs/solidcraft/issues/1597). See the [`help wanted`](https://github.com/tangency-labs/solidcraft/labels/help%20wanted) and [`good first issue`](https://github.com/tangency-labs/solidcraft/labels/good%20first%20issue) labels. diff --git a/apps/solidcraft/src/startup.rs b/apps/solidcraft/src/startup.rs index cb94b441..f423869e 100644 --- a/apps/solidcraft/src/startup.rs +++ b/apps/solidcraft/src/startup.rs @@ -199,7 +199,7 @@ pub fn no_window_message(error: &str, settings: Option<&Path>) -> String { - Over Remote Desktop or in a virtual machine, enable 3D acceleration or run it on the machine itself.\n\ - Start it once with `solidcraft --safe-mode`.\n\ - Rename the settings folder: {folder}\n\n\ - More: https://bherbruck.github.io/solidcraft/guide/troubleshooting.html" + More: https://docs.solidcraft.io/guide/troubleshooting.html" ) } diff --git a/assets/platforms/linux/ai.storyteller.solidcraft.metainfo.xml.in b/assets/platforms/linux/ai.storyteller.solidcraft.metainfo.xml.in index 8983472d..169907fb 100644 --- a/assets/platforms/linux/ai.storyteller.solidcraft.metainfo.xml.in +++ b/assets/platforms/linux/ai.storyteller.solidcraft.metainfo.xml.in @@ -26,9 +26,9 @@ ai.storyteller.solidcraft.desktop ai.storyteller.solidcraft - https://bherbruck.github.io/solidcraft/ + https://docs.solidcraft.io/ https://github.com/bherbruck/solidcraft/issues - https://bherbruck.github.io/solidcraft/ + https://docs.solidcraft.io/ Graphics 3DGraphics diff --git a/assets/platforms/windows/solidcraft.wxs b/assets/platforms/windows/solidcraft.wxs index 3dcdef06..42c8ec4b 100644 --- a/assets/platforms/windows/solidcraft.wxs +++ b/assets/platforms/windows/solidcraft.wxs @@ -34,7 +34,7 @@ - + diff --git a/crates/ui-egui/src/help.rs b/crates/ui-egui/src/help.rs index 2d66e603..5b751a1e 100644 --- a/crates/ui-egui/src/help.rs +++ b/crates/ui-egui/src/help.rs @@ -11,7 +11,7 @@ pub const VERSION: &str = env!("CARGO_PKG_VERSION"); pub const COMMIT: &str = env!("SOLIDCRAFT_COMMIT"); pub const BUILD_DATE: &str = env!("SOLIDCRAFT_BUILD_DATE"); /// The user and developer guide (docs/book, published by .github/workflows/pages.yml). -pub const DOCS_URL: &str = "https://bherbruck.github.io/solidcraft/"; +pub const DOCS_URL: &str = "https://docs.solidcraft.io/"; const ATTRIBUTION: &str = include_str!("../../../ATTRIBUTION.md"); use solidcraft_engine::licences::{LICENSE_APACHE, LICENSE_MIT, NOTICE, THIRD_PARTY}; /// Fonts: what this build carries. diff --git a/docs/book/src/guide/getting-started.md b/docs/book/src/guide/getting-started.md index 516a0976..b36c8711 100644 --- a/docs/book/src/guide/getting-started.md +++ b/docs/book/src/guide/getting-started.md @@ -45,11 +45,16 @@ to the same user installation: ```sh flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo -flatpak remote-add --user --if-not-exists solidcraft https://bherbruck.github.io/solidcraft/flatpak/solidcraft.flatpakrepo +flatpak remote-add --user --if-not-exists solidcraft https://docs.solidcraft.io/flatpak/solidcraft.flatpakrepo flatpak install --user solidcraft ai.storyteller.solidcraft flatpak run ai.storyteller.solidcraft ``` +A SolidCraft remote added before the project moved to `docs.solidcraft.io` (from +`bherbruck.github.io`) no longer finds updates. Point it at the new address, then update: +`flatpak remote-modify --user --url=https://docs.solidcraft.io/flatpak/repo/ solidcraft` and +`flatpak update --user`. + Releases up to 0.7 used the application ID `ai.storyteller.solvecraft`. If you installed one of those from the SolidCraft remote, `flatpak update --user` reports it as end-of-life and offers to replace it with `ai.storyteller.solidcraft`; accept, and your settings and autosaves move with diff --git a/docs/compatibility.md b/docs/compatibility.md index 1c4f97cb..9ecc3a6f 100644 --- a/docs/compatibility.md +++ b/docs/compatibility.md @@ -158,8 +158,11 @@ replace any Dock shortcut with the old name (open `SolidCraft.app`, then ## Flatpak remotes added from the former website address -`flatpak remote-modify --user --url=https://bherbruck.github.io/solidcraft/flatpak/repo/ solvecraft` -(use your remote's name), then `flatpak update --user`. +The feed has moved twice: from the SolveCraft address, then from `bherbruck.github.io/solidcraft` +when the project moved to `docs.solidcraft.io` (#1920). A remote added from either address no +longer finds updates. Point it at the current one: +`flatpak remote-modify --user --url=https://docs.solidcraft.io/flatpak/repo/ solidcraft` +(use your remote's name: `solvecraft` for one added before 0.4), then `flatpak update --user`. ## Draft design containers diff --git a/packaging/linux/nfpm.yaml b/packaging/linux/nfpm.yaml index a258894b..a6e2da1f 100644 --- a/packaging/linux/nfpm.yaml +++ b/packaging/linux/nfpm.yaml @@ -20,7 +20,7 @@ section: graphics priority: optional maintainer: ${SOLIDCRAFT_MAINTAINER} vendor: SolidCraft contributors -homepage: https://bherbruck.github.io/solidcraft/ +homepage: https://docs.solidcraft.io/ license: MIT OR Apache-2.0 description: |- Open-source parametric 3D CAD in the style of Fusion diff --git a/packaging/linux/snap/snapcraft.yaml b/packaging/linux/snap/snapcraft.yaml index 0a00b96f..3f6f75ed 100644 --- a/packaging/linux/snap/snapcraft.yaml +++ b/packaging/linux/snap/snapcraft.yaml @@ -25,7 +25,7 @@ description: | adopt-info: solidcraft license: MIT OR Apache-2.0 contact: https://github.com/bherbruck/solidcraft/issues -website: https://bherbruck.github.io/solidcraft/ +website: https://docs.solidcraft.io/ source-code: https://github.com/bherbruck/solidcraft issues: https://github.com/bherbruck/solidcraft/issues icon: stage/share/icons/hicolor/512x512/apps/ai.storyteller.solidcraft.png