[Doxygen] Add documentation for beta channel. (#6510)

* [Doxygen] Add documentation for beta channel.

Took 36 minutes

* [Doxygen] Use default theme.

Took 13 minutes

---------

Co-authored-by: Lukas Brübach <Bruebach.Lukas@bdosecurity.de>

cockatrice/src/interface/widgets/deck_editor/deck_editor_deck_dock_widget.cpp

@@ -459,12 +459,15 @@ void DeckEditorDeckDockWidget::syncBannerCardComboBoxSelectionWithDeck()
     }
 }
 
-void DeckEditorDeckDockWidget::setSelectedIndex(const QModelIndex &newCardIndex)
+void DeckEditorDeckDockWidget::setSelectedIndex(const QModelIndex &newCardIndex, bool preserveWidgetFocus)
 {
     deckView->clearSelection();
     deckView->setCurrentIndex(newCardIndex);
     recursiveExpand(newCardIndex);
-    deckView->setFocus(Qt::FocusReason::MouseFocusReason);
+
+    if (!preserveWidgetFocus) {
+        deckView->setFocus(Qt::FocusReason::MouseFocusReason);
+    }
 }
 
 void DeckEditorDeckDockWidget::syncDisplayWidgetsToModel()

cockatrice/src/interface/widgets/deck_editor/deck_editor_deck_dock_widget.h

@@ -100,7 +100,7 @@ private slots:
     void writeComments();
     void writeBannerCard(int);
     void applyActiveGroupCriteria();
-    void setSelectedIndex(const QModelIndex &newCardIndex);
+    void setSelectedIndex(const QModelIndex &newCardIndex, bool preserveWidgetFocus);
     void updateHash();
     void refreshShortcuts();
     void updateShowBannerCardComboBox(bool visible);

cockatrice/src/interface/widgets/deck_editor/deck_state_manager.cpp

@@ -182,7 +182,7 @@ QModelIndex DeckStateManager::addCard(const ExactCard &card, const QString &zone
     QModelIndex idx = modifyDeck(reason, [&card, &zone](auto model) { return model->addCard(card, zone); });
 
     if (idx.isValid()) {
-        emit focusIndexChanged(idx);
+        emit focusIndexChanged(idx, true);
     }
 
     return idx;
@@ -208,7 +208,7 @@ QModelIndex DeckStateManager::decrementCard(const ExactCard &card, const QString
     }
 
     if (idx.isValid()) {
-        emit focusIndexChanged(idx);
+        emit focusIndexChanged(idx, true);
     }
 
     return idx;

cockatrice/src/interface/widgets/deck_editor/deck_state_manager.h

@@ -290,8 +290,9 @@ signals:
     /**
      * The selected card on any views connected to this deck should be changed to this index.
      * @param index The model index
+     * @param preserveWidgetFocus Whether to keep the widget focus unchanged
      */
-    void focusIndexChanged(QModelIndex index);
+    void focusIndexChanged(QModelIndex index, bool preserveWidgetFocus);
 };
 
 #endif // COCKATRICE_DECK_STATE_MANAGER_H

cockatrice/src/interface/widgets/printing_selector/card_amount_widget.cpp

@@ -198,7 +198,7 @@ void CardAmountWidget::addPrinting(const QString &zone)
     });
 
     if (newCardIndex.isValid()) {
-        emit deckStateManager->focusIndexChanged(newCardIndex);
+        emit deckStateManager->focusIndexChanged(newCardIndex, false);
     }
 }
 

doc/doxygen/extra-pages/user_documentation/index.md

@@ -1,9 +1,17 @@
 @page user_reference User Reference
-
-- @subpage search_syntax_help
-- @subpage deck_search_syntax_help
  
+# Deck Management
+
 - @subpage creating_decks
 - @subpage importing_decks
 - @subpage editing_decks
 - @subpage exporting_decks
+
+# Release Channels
+
+- @subpage beta_release
+
+# Syntax Help
+
+- @subpage search_syntax_help
+- @subpage deck_search_syntax_help

doc/doxygen/extra-pages/user_documentation/settings/beta.md

@@ -0,0 +1,54 @@
+@page beta_release Beta Release
+
+The beta version of Cockatrice features all the newest features before they make their way into the latest stable
+release.
+It allows us to test these features ahead of time and you to give feedback on them.
+We release new betas very frequently and usually release a follow-up beta with a fix within a day or two if we break
+anything. In contrast, stable releases are released much less frequently but ensured to be stable.
+
+# What to Expect from the Beta
+
+Using the beta and giving feedback on it helps us improve Cockatrice a lot.
+We do not perform any automatic data collection so your voluntary feedback is the only way for us to get a sense of what
+you enjoy, expect, or would like to change.
+
+We highly appreciate your active participation and feedback.
+
+That being said, some words of warning should be issued:
+
+The beta release may contain unfinished features, bugs, or performance issues.
+It is intended for testing and feedback and may be less stable than the default release.
+
+We recommend using the beta only if you are comfortable encountering issues and helping us improve Cockatrice.
+
+# Switching to the Beta
+
+To switch to the Beta, navigate to your settings, using the Tab "Cockatrice → Settings" or Ctrl + Shift + P (default
+shortcut).
+
+Within the settings, in the first tab 'General', the first section 'Personal Settings' contains the setting 'Release
+Channel'.
+
+\image html release_channel_beta.png
+
+Switch this to 'Beta'.
+
+Afterwards, close your settings, and use the 'Help' tab to search for a client update. You should be prompted to install
+the beta version.
+
+# Switching back to Stable
+
+Follow the same steps as above, but set Release Channel to 'Default'.
+
+# Giving Feedback
+
+If you encounter a bug or unexpected behavior while using the beta, please report it on:
+
+- GitHub: https://github.com/Cockatrice/Cockatrice/issues
+- Discord: https://discord.gg/4hNswvHeFd in #beta-testing
+
+When reporting issues, please include:
+
+- Your operating system
+- The beta version number (found in 'Help → About Cockatrice')
+- Steps to reproduce the problem, if possible