From 76af6857bbbb9e23cada96793294df2df564305d Mon Sep 17 00:00:00 2001 From: Albert Snow Date: Thu, 19 Oct 2023 19:55:04 -0500 Subject: [PATCH 1/7] initial commit --- src/SUMMARY.md | 6 ++++++ src/en/testing/introduction/explanation.md | 5 +++++ src/en/testing/maps/basics.md | 0 src/en/testing/maps/introduction.md | 0 4 files changed, 11 insertions(+) create mode 100644 src/en/testing/introduction/explanation.md create mode 100644 src/en/testing/maps/basics.md create mode 100644 src/en/testing/maps/introduction.md diff --git a/src/SUMMARY.md b/src/SUMMARY.md index e75d8b3f..093942d1 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -53,6 +53,12 @@ SS14 By Example - [UI Survival Guide](en/ss14-by-example/ui-survival-guide.md) +Testing +============== +- [Introduction to Testing](en/testing/introduction/explanation.md) +- [Maps](en/testing/maps/introduction.md) + - [Basics](en/testing/maps/basics.md) + Robust Toolbox ============== diff --git a/src/en/testing/introduction/explanation.md b/src/en/testing/introduction/explanation.md new file mode 100644 index 00000000..5dc0b619 --- /dev/null +++ b/src/en/testing/introduction/explanation.md @@ -0,0 +1,5 @@ +# Testing SS14 + +Testing code is critical to a software application's long-term viability. SS14 is, from a developer's perspective, a complex game with many moving parts; all the more reason to ensure it's well tested. The motivation of this section is to add testing documentation to help streamline the testing process, and minimize redundant questions about basic yet integral testing concepts. + +Contributions to this section should seek to elucidate various non-obvious testing concepts, and provide answers to various general "How do I test X?" kinds of questions. diff --git a/src/en/testing/maps/basics.md b/src/en/testing/maps/basics.md new file mode 100644 index 00000000..e69de29b diff --git a/src/en/testing/maps/introduction.md b/src/en/testing/maps/introduction.md new file mode 100644 index 00000000..e69de29b From bc8bd5f96bd2753dcf3c94dd31db99b23fa15d68 Mon Sep 17 00:00:00 2001 From: Albert Snow Date: Thu, 19 Oct 2023 19:56:46 -0500 Subject: [PATCH 2/7] add todo --- src/en/testing/maps/basics.md | 1 + src/en/testing/maps/introduction.md | 1 + 2 files changed, 2 insertions(+) diff --git a/src/en/testing/maps/basics.md b/src/en/testing/maps/basics.md index e69de29b..30404ce4 100644 --- a/src/en/testing/maps/basics.md +++ b/src/en/testing/maps/basics.md @@ -0,0 +1 @@ +TODO \ No newline at end of file diff --git a/src/en/testing/maps/introduction.md b/src/en/testing/maps/introduction.md index e69de29b..30404ce4 100644 --- a/src/en/testing/maps/introduction.md +++ b/src/en/testing/maps/introduction.md @@ -0,0 +1 @@ +TODO \ No newline at end of file From ef0ee9ce087ef7b7aa690692ab6ac76e3177d8ba Mon Sep 17 00:00:00 2001 From: Albert Snow Date: Thu, 19 Oct 2023 23:46:48 -0500 Subject: [PATCH 3/7] adding the barest of descriptions --- src/en/testing/introduction/explanation.md | 2 +- src/en/testing/maps/basics.md | 4 +++- src/en/testing/maps/introduction.md | 4 +++- 3 files changed, 7 insertions(+), 3 deletions(-) diff --git a/src/en/testing/introduction/explanation.md b/src/en/testing/introduction/explanation.md index 5dc0b619..bbb2dc99 100644 --- a/src/en/testing/introduction/explanation.md +++ b/src/en/testing/introduction/explanation.md @@ -2,4 +2,4 @@ Testing code is critical to a software application's long-term viability. SS14 is, from a developer's perspective, a complex game with many moving parts; all the more reason to ensure it's well tested. The motivation of this section is to add testing documentation to help streamline the testing process, and minimize redundant questions about basic yet integral testing concepts. -Contributions to this section should seek to elucidate various non-obvious testing concepts, and provide answers to various general "How do I test X?" kinds of questions. +Contributions to this section should seek to elucidate various non-obvious testing concepts, and provide answers to various general "How do I test X?" kinds of questions. If you need to test something, but you're not sure how, look here. If the answer isn't here, add it! diff --git a/src/en/testing/maps/basics.md b/src/en/testing/maps/basics.md index 30404ce4..e6745758 100644 --- a/src/en/testing/maps/basics.md +++ b/src/en/testing/maps/basics.md @@ -1 +1,3 @@ -TODO \ No newline at end of file +# Basic Map Testing + +This section is intended to contain information about the basics of testing various maps in SS14. diff --git a/src/en/testing/maps/introduction.md b/src/en/testing/maps/introduction.md index 30404ce4..f9a02086 100644 --- a/src/en/testing/maps/introduction.md +++ b/src/en/testing/maps/introduction.md @@ -1 +1,3 @@ -TODO \ No newline at end of file +# Testing Maps + +This section is intended to contain information about how to test maps, specifically. From 86c8f7d0c69efd944528a1f4cf85d4601099fee4 Mon Sep 17 00:00:00 2001 From: Albert Snow Date: Fri, 20 Oct 2023 00:02:45 -0500 Subject: [PATCH 4/7] add example --- src/en/testing/maps/basics.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/src/en/testing/maps/basics.md b/src/en/testing/maps/basics.md index e6745758..85b18a72 100644 --- a/src/en/testing/maps/basics.md +++ b/src/en/testing/maps/basics.md @@ -1,3 +1,16 @@ # Basic Map Testing This section is intended to contain information about the basics of testing various maps in SS14. + +## How do I load maps? + +So you start the application, and are able to boot into that development room right? Cool. Now how do you boot into a different map. + +There are a lot of console commands you can run from the terminal to +initiate various behaviors. In this case, we want to run a command to +switch maps. To open the terminal, press the backtick " ` " key. + +Then the commands are as follows. +- `Forcemap ` <-- to set the map to switch to +- `restartroundnow` <-- to go back to the lobby +- `startround` <-- to start the next round \ No newline at end of file From dee24b8b471d56afd0a890367df4a5eaf2a38cff Mon Sep 17 00:00:00 2001 From: Albert Snow Date: Fri, 20 Oct 2023 00:12:42 -0500 Subject: [PATCH 5/7] add antagonist section --- src/en/testing/antags/basics.md | 11 +++++++++++ src/en/testing/antags/introduction.md | 3 +++ 2 files changed, 14 insertions(+) create mode 100644 src/en/testing/antags/basics.md create mode 100644 src/en/testing/antags/introduction.md diff --git a/src/en/testing/antags/basics.md b/src/en/testing/antags/basics.md new file mode 100644 index 00000000..1c95312f --- /dev/null +++ b/src/en/testing/antags/basics.md @@ -0,0 +1,11 @@ +# Basic Antagonist Testing + +This section is intended to contain information about the basics of testing various maps in SS14. + +## How do I test a round scenario like Nukies? + +In the game terminal: + +- `sudo cvar game.lobbyenabled true` +- `restartroundnow` +- `forcepreset Nukeops` diff --git a/src/en/testing/antags/introduction.md b/src/en/testing/antags/introduction.md new file mode 100644 index 00000000..8b305960 --- /dev/null +++ b/src/en/testing/antags/introduction.md @@ -0,0 +1,3 @@ +# Testing Antags + +This section is intended to contain information about how to test various antagonist features. From 5aa131e9bfc760cbbf576c7fb110d81ff0353eb3 Mon Sep 17 00:00:00 2001 From: Albert Snow Date: Fri, 20 Oct 2023 00:14:13 -0500 Subject: [PATCH 6/7] add to summary --- src/SUMMARY.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/SUMMARY.md b/src/SUMMARY.md index 093942d1..df30e8ff 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -58,6 +58,8 @@ Testing - [Introduction to Testing](en/testing/introduction/explanation.md) - [Maps](en/testing/maps/introduction.md) - [Basics](en/testing/maps/basics.md) +- [Antagonists](en/testing/antags/introduction.md) + - [Basics](en/testing/antags/basics.md) Robust Toolbox ============== From a16ed365c09c1effd85136e1967e9f6b87c8ea34 Mon Sep 17 00:00:00 2001 From: Albert Snow Date: Fri, 20 Oct 2023 00:14:55 -0500 Subject: [PATCH 7/7] typo --- src/en/testing/antags/basics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/en/testing/antags/basics.md b/src/en/testing/antags/basics.md index 1c95312f..38b70037 100644 --- a/src/en/testing/antags/basics.md +++ b/src/en/testing/antags/basics.md @@ -1,6 +1,6 @@ # Basic Antagonist Testing -This section is intended to contain information about the basics of testing various maps in SS14. +This section is intended to contain information about the basics of testing various antag features in SS14. ## How do I test a round scenario like Nukies?