Skip to content

Updated resources for v3 release#428

Open
nefarius wants to merge 4 commits intomasterfrom
v3-stable-release
Open

Updated resources for v3 release#428
nefarius wants to merge 4 commits intomasterfrom
v3-stable-release

Conversation

@nefarius
Copy link
Copy Markdown
Owner

@nefarius nefarius commented Mar 30, 2026

Summary by CodeRabbit

  • Documentation

    • Updated in-app links, installer dialog copy and hyperlink labels to point to the current Version 3 stable documentation and to read “Open documentation.”
    • Adjusted installer messaging to say a web page should open in the default browser.
  • Chores

    • Changed release labeling from “Version 3 (Beta)” to “Version 3 (Stable).”

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Mar 30, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: b35d72fa-14f9-415d-9b7f-08b9ab723205

📥 Commits

Reviewing files that changed from the base of the PR and between 7b4cbf2 and 2dd0eb3.

📒 Files selected for processing (1)
  • setup/Dialogs/OnlineDocumentationDialog.xaml.cs

📝 Walkthrough

Walkthrough

Replaces beta/experimental documentation links and wording with stable v3 documentation across UI, installer, and README; renames BetaArticleDialog to OnlineDocumentationDialog, adds its dialog class and view-model, and updates installer custom action and URL references.

Changes

Cohort / File(s) Summary
Release Status
README.md
Changed release wording from "Version 3 (Beta)" to "Version 3 (Stable)" and updated related copy about obtaining builds.
Devices Page Link
ControlApp/Views/Pages/DevicesPage.xaml
Updated ui:HyperlinkButton NavigateUri to point to the stable v3 troubleshooting anchor (.../v3/How-to-Install/#troubleshooting).
Documentation Dialog XAML
setup/Dialogs/OnlineDocumentationDialog.xaml
Renamed XAML x:Class to OnlineDocumentationDialog, adjusted displayed message and hyperlink text/URL to the v3 documentation, and added trailing newline.
Installer Dialog & Model
setup/Dialogs/OnlineDocumentationDialog.xaml.cs
Added OnlineDocumentationDialog WPF dialog and OnlineDocumentationDialogModel (Init, DataContext wiring, Next handling, hyperlink navigation opening InstallScript.OnlineDocumentationUrl).
Installer Script & Actions
setup/InstallScript.cs
Replaced BetaArticleUrl with OnlineDocumentationUrl, renamed custom action OpenBetaArticleOpenOnlineDocumentation, updated managed UI dialog chain and exception log messages.

Sequence Diagram(s)

sequenceDiagram
    participant InstallScript as InstallScript
    participant MSI_UI as OnlineDocumentationDialog
    participant Model as OnlineDocumentationDialogModel
    participant OS as Browser (Process)

    InstallScript->>MSI_UI: Launch OnlineDocumentationDialog
    MSI_UI->>Model: Init() / set DataContext
    User->>MSI_UI: Click "Open documentation" link
    MSI_UI->>Model: Hyperlink navigation handler
    Model->>OS: Process.Start(InstallScript.OnlineDocumentationUrl)
    OS-->>Model: (browser opens / error)
    User->>MSI_UI: Click Next
    MSI_UI->>Model: GoNext()
    Model->>InstallScript: Shell.GoNext()
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Suggested labels

documentation, enhancement

Poem

🐰 From beta burrows to stable ground,
Links retied and class renamed found.
A dialog hops in, bright and spry,
Opens docs in your browser's sky.
Version three now steady—hop, don't bound.

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Updated resources for v3 release' accurately reflects the core changes across all modified files: updating documentation URLs from beta to stable v3, renaming beta article references to online documentation, and updating release status from beta to stable.
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch v3-stable-release

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Mar 30, 2026

Note

Docstrings generation - SUCCESS
Generated docstrings and committed to branch v3-stable-release (commit: 7b4cbf2ea5e0888bd8acf5bac25214fc760e5e5e)

Docstrings generation was requested by @nefarius.

The following files were modified:

* `setup/Dialogs/OnlineDocumentationDialog.xaml.cs`
* `setup/InstallScript.cs`

These file types are not supported:
* `ControlApp/Views/Pages/DevicesPage.xaml`
* `README.md`
* `setup/Dialogs/OnlineDocumentationDialog.xaml`
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (1)
setup/Dialogs/OnlineDocumentationDialog.xaml.cs (1)

28-33: Consider declaring the field before its usage.

The _model field is declared on line 33 after being used in Init() on line 30. While this is valid C#, conventional ordering places field declarations before methods for better readability.

♻️ Optional reordering
 public partial class OnlineDocumentationDialog : WpfDialog, IWpfDialog
 {
+    private OnlineDocumentationDialogModel _model;
+
     /// <summary>
     /// Initializes a new instance of OnlineDocumentationDialog and initializes its WPF UI components.
     /// </summary>
     public OnlineDocumentationDialog()
     {
         InitializeComponent();
     }

     /// ...
     public void Init()
     {
         DataContext = _model = new OnlineDocumentationDialogModel { Host = ManagedFormHost };
     }

-    private OnlineDocumentationDialogModel _model;
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@setup/Dialogs/OnlineDocumentationDialog.xaml.cs` around lines 28 - 33, The
_model field is declared after it’s used in Init(), which hurts readability;
move the field declaration for _model (type OnlineDocumentationDialogModel)
above the Init() method (so it's declared before DataContext/_model assignment)
or alternatively initialize it inline at declaration to ensure the field appears
before methods like Init() that reference it.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@setup/InstallScript.cs`:
- Around line 374-380: The XML documentation for the donation page opener
contains a malformed/unclosed <summary> tag; locate the docblock immediately
above the method that opens the donations page (the comment starting "Open
donations page in default browser." / "Opens the donation web page..." in
InstallScript.cs) and fix the XML by removing the extra opening <summary> or
closing it properly so there is exactly one well-formed <summary> ... </summary>
element, ensure the <param> and <returns> tags remain intact and valid, and run
the compiler or XML doc check to verify the warning is gone.
- Around line 351-357: The XML doc for the method that opens the product's
online documentation has a malformed/unclosed <summary> tag; edit the
documentation above that method (the comment block describing "Open online
documentation in default browser" / "Opens the product's online documentation
URL in the user's default browser") to remove the stray duplicate <summary>
start tag and ensure there is a single properly opened and closed <summary>
section (i.e., one <summary> ... </summary>) and keep the <param> and <returns>
tags unchanged so the XML documentation is well-formed for the method that
launches the docs.
- Around line 301-307: The XML doc for the method that downloads and installs
BthPS3 contains an unclosed <summary> tag (the first summary before the one
describing downloading metadata); close the initial <summary> properly (or
remove the duplicate) so there is a single well-formed <summary> section for the
method that references the session parameter and return information; update the
XML comment surrounding the "Download and install BthPS3" description to be one
coherent <summary> block and ensure all XML tags are properly closed.

---

Nitpick comments:
In `@setup/Dialogs/OnlineDocumentationDialog.xaml.cs`:
- Around line 28-33: The _model field is declared after it’s used in Init(),
which hurts readability; move the field declaration for _model (type
OnlineDocumentationDialogModel) above the Init() method (so it's declared before
DataContext/_model assignment) or alternatively initialize it inline at
declaration to ensure the field appears before methods like Init() that
reference it.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 47dff494-d170-4802-a124-3f99bf74c764

📥 Commits

Reviewing files that changed from the base of the PR and between 40f5f9b and 7b4cbf2.

📒 Files selected for processing (2)
  • setup/Dialogs/OnlineDocumentationDialog.xaml.cs
  • setup/InstallScript.cs

Keep _model field before constructor; combine with XML docs from incoming branch.

Made-with: Cursor
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant