wip sys features

2sic · Dec 21, 2023 · 5bd98f4 · 5bd98f4
1 parent a237e4a
commit 5bd98f4
Show file tree

Hide file tree

Showing 9 changed files with 95 additions and 63 deletions.
diff --git a/2sxc Docs Generator/pages/abyss/platforms/assets/sys-features-warning-missing.jpg b/2sxc Docs Generator/pages/abyss/platforms/assets/sys-features-warning-missing.jpg
diff --git a/2sxc Docs Generator/pages/abyss/platforms/dnn/system-features.md b/2sxc Docs Generator/pages/abyss/platforms/dnn/system-features.md
@@ -7,25 +7,35 @@ uid: Abyss.Platforms.Dnn.SystemFeatures
 Dnn comes with a lot of features pre-installed.
 Others can be installed later on, as needed.
 
+> [!TIP]
+> 2sxc 17 requires C# v8.
+>
+> This will be pre-installed in Dnn 10, but for Dnn 9.6.1+ you need to install it manually.
+> 
+> For this specific issue, please check <https://r.2sxc.org/dnn-roslyn>
+
 Sometimes you may install an App which requires an additional capability.
 This page should guide you through installing them if you're stuck.
-Look for the code you received, such as `System-CSharp07` to find the instruction.
+Look for the code you received, such as `System-CSharp08` to find the instruction.
 
 ## Additional System Capabilities
 
 The following are are capabilities which may or may not be pre-installed.
 
-### C# 6 / C# 8 - `System-CSharp06` - `System-CSharp08`
+### C# v6 to v8 - `System-CSharp06` to `System-CSharp08`
 
 Dnn v.7.x - 9.x all include C# 5, but not C# 6+.
-C# 7 was once installed by default, but was reset to **include but not auto-install** because of
+C# 6 was once installed by default, but was reset to **include but not auto-install** because of
 [issues with the hosting provider GoDaddy](https://dnntracker.atlassian.net/browse/DNN-8528).
 
 Depending on your Dnn version, it has a different CodeDom / CSharp Compiler prepared for you:
 
 * Dnn 9.6.1 has prepared the CodeDom v2.0.1 containing C# 6 for .net 4.5
-* Dnn 9.? ??? C# 7
-* Dnn 9.13 ? has C# 8
+* Dnn ca. 9.10+ has C# 7.3 and C# 8 (called CodeDom 3.6)
+
+> [!IMPORTANT]
+> If you're on Dnn 9.6.1, you can install C# 8 manually.
+> See <https://r.2sxc.org/dnn-roslyn>
 
 <iframe src="https://azing.org/dnn-community/r/ogPu9EDH?embed=1" width="100%" height="600" frameborder="0" allowfullscreen style="box-shadow: 0 1px 3px rgba(60,64,67,.3), 0 4px 8px 3px rgba(60,64,67,.15)"></iframe>
 <!-- <script src="https://cdn.azing.org/e/1/embed.js"></script> -->
@@ -35,22 +45,27 @@ Depending on your Dnn version, it has a different CodeDom / CSharp Compiler prep
 
 The following are always available in every Dnn:
 
-* `SystemCapability-NetFramework`
-* `SystemCapability-Razor`
-* `SystemCapability-CSharp05`
+* `System-NetFramework`
+* `System-Razor`
+* `System-CSharp05`
+
+## Optional System Capabilities
+
+* `System-CSharp06`
+* `System-CSharp07`
+* `System-CSharp08`
 
 ## Unavailable System Capabilities
 
 The following are listed just to clarify that they currently don't exist in DNN and
 probably cannot be added in any feasible way.
 
-* `SystemCapability-CSharp08` .net 3 (core)
-* `SystemCapability-CSharp09` .net 5 (core)
-* `SystemCapability-CSharp10` .net 6 (core)
-* `SystemCapability-CSharp11` .net 7 (core)
-* `SystemCapability-CSharp12` .net 8 (core)
-* `SystemCapability-NetCore` Dnn is .net Framework only as of now
-* `SystemCapability-Blazor` requires .net Core v3+; works in Oqtane
+* `System-CSharp09` .net 5 (core)
+* `System-CSharp10` .net 6 (core)
+* `System-CSharp11` .net 7 (core)
+* `System-CSharp12` .net 8 (core)
+* `System-NetCore` Dnn is .net Framework only as of now
+* `System-Blazor` requires .net Core v3+; works in Oqtane
 
 ---
 

diff --git a/2sxc Docs Generator/pages/abyss/platforms/oqtane/system-features.md b/2sxc Docs Generator/pages/abyss/platforms/oqtane/system-features.md
@@ -9,7 +9,7 @@ Others can be installed later on, as needed.
 
 Sometimes you may install an App which requires an additional capability.
 This page should guide you through installing them if you're stuck.
-Look for the code you received, such as `SystemCapability-DataSource-SharePoint` to find the instruction.
+Look for the code you received, such as `System-DataSource-SharePoint` to find the instruction.
 
 ## Additional System Capabilities
 
@@ -22,22 +22,22 @@ The following are are capabilities which may or may not be pre-installed.
 
 The following are always available in every Dnn:
 
-* `SystemCapability-NetCore`
-* `SystemCapability-Razor`
-* `SystemCapability-Blazor`
-* `SystemCapability-CSharp07`
-* `SystemCapability-CSharp08`
-* `SystemCapability-CSharp09`
-* `SystemCapability-CSharp10`
-* `SystemCapability-CSharp11` .net 7 (core) - Oqtane 4
+* `System-NetCore`
+* `System-Razor`
+* `System-Blazor`
+* `System-CSharp07`
+* `System-CSharp08`
+* `System-CSharp09`
+* `System-CSharp10`
+* `System-CSharp11` .net 7 (core) - Oqtane 4
 
 ## Unavailable System Capabilities
 
 The following are listed just to clarify that they currently don't exist in DNN and
 probably cannot be added in any feasible way.
 
-* `SystemCapability-CSharp12` .net 8 (core) - wait for Oqtane 5
-* `SystemCapability-NetFramework` Oqtane is .net Core only
+* `System-CSharp12` .net 8 (core) - wait for Oqtane 5
+* `System-NetFramework` Oqtane is .net Core only
 
 ---
 

diff --git a/2sxc Docs Generator/pages/abyss/platforms/system-features.md b/2sxc Docs Generator/pages/abyss/platforms/system-features.md
@@ -7,6 +7,10 @@ uid: Abyss.Platforms.SystemFeatures
 All platforms come with a lot of features pre-installed.
 Others can be installed later on, as needed.
 
+You probably arrived here, because you saw a warning similar to this:
+
+<img src="./assets/sys-features-warning-missing.jpg" class="full-width">
+
 To find out how to add features, check the section of your platform:
 
 * ☢️ [DNN](xref:Abyss.Platforms.Dnn.SystemFeatures)
@@ -15,11 +19,8 @@ To find out how to add features, check the section of your platform:
 
 ## Alternative: Configure Apps to not Request said Features
 
-You probably arrived here because an App you installed requires a feature which is not installed.
-
-<img src="./assets/sys-features-warning-missing.jpg" class="full-width">
-
-If you can't install it and want to disable the warning to see what you can do about it,
+If the feature was only required by the App configuration, you can also disable that warning.
+You would do this if you can't install it and want to disable the warning to see what you can do about it,
 we've created a checklist for this:
 
 <iframe src="https://azing.org/2sxc/r/cXiefhIX?embed=1" width="100%" height="400" frameborder="0" allowfullscreen style="box-shadow: 0 1px 3px rgba(60,64,67,.3), 0 4px 8px 3px rgba(60,64,67,.15)"></iframe>

diff --git a/docs/abyss/platforms/dnn/system-features.html b/docs/abyss/platforms/dnn/system-features.html
@@ -110,41 +110,56 @@ <h1 id="dnn-system-features">Dnn System Features</h1>
 
 <p>Dnn comes with a lot of features pre-installed.
 Others can be installed later on, as needed.</p>
+<div class="TIP">
+<h5>Tip</h5>
+<p>2sxc 17 requires C# v8.</p>
+<p>This will be pre-installed in Dnn 10, but for Dnn 9.6.1+ you need to install it manually.</p>
+<p>For this specific issue, please check <a href="https://r.2sxc.org/dnn-roslyn">https://r.2sxc.org/dnn-roslyn</a></p>
+</div>
 <p>Sometimes you may install an App which requires an additional capability.
 This page should guide you through installing them if you're stuck.
-Look for the code you received, such as <code>System-CSharp07</code> to find the instruction.</p>
+Look for the code you received, such as <code>System-CSharp08</code> to find the instruction.</p>
 <h2 id="additional-system-capabilities">Additional System Capabilities</h2>
 <p>The following are are capabilities which may or may not be pre-installed.</p>
-<h3 id="c-6--c-8---system-csharp06---system-csharp08">C# 6 / C# 8 - <code>System-CSharp06</code> - <code>System-CSharp08</code></h3>
+<h3 id="c-v6-to-v8---system-csharp06-to-system-csharp08">C# v6 to v8 - <code>System-CSharp06</code> to <code>System-CSharp08</code></h3>
 <p>Dnn v.7.x - 9.x all include C# 5, but not C# 6+.
-C# 7 was once installed by default, but was reset to <strong>include but not auto-install</strong> because of
+C# 6 was once installed by default, but was reset to <strong>include but not auto-install</strong> because of
 <a href="https://dnntracker.atlassian.net/browse/DNN-8528">issues with the hosting provider GoDaddy</a>.</p>
 <p>Depending on your Dnn version, it has a different CodeDom / CSharp Compiler prepared for you:</p>
 <ul>
 <li>Dnn 9.6.1 has prepared the CodeDom v2.0.1 containing C# 6 for .net 4.5</li>
-<li>Dnn 9.? ??? C# 7</li>
-<li>Dnn 9.13 ? has C# 8</li>
+<li>Dnn ca. 9.10+ has C# 7.3 and C# 8 (called CodeDom 3.6)</li>
 </ul>
+<div class="IMPORTANT">
+<h5>Important</h5>
+<p>If you're on Dnn 9.6.1, you can install C# 8 manually.
+See <a href="https://r.2sxc.org/dnn-roslyn">https://r.2sxc.org/dnn-roslyn</a></p>
+</div>
 <iframe src="https://azing.org/dnn-community/r/ogPu9EDH?embed=1" width="100%" height="600" frameborder="0" allowfullscreen="" style="box-shadow: 0 1px 3px rgba(60,64,67,.3), 0 4px 8px 3px rgba(60,64,67,.15)"></iframe>
 <!-- <script src="https://cdn.azing.org/e/1/embed.js"></script> -->
 <h2 id="preinstalled-system-capabilities">Preinstalled System Capabilities</h2>
 <p>The following are always available in every Dnn:</p>
 <ul>
-<li><code>SystemCapability-NetFramework</code></li>
-<li><code>SystemCapability-Razor</code></li>
-<li><code>SystemCapability-CSharp05</code></li>
+<li><code>System-NetFramework</code></li>
+<li><code>System-Razor</code></li>
+<li><code>System-CSharp05</code></li>
+</ul>
+<h2 id="optional-system-capabilities">Optional System Capabilities</h2>
+<ul>
+<li><code>System-CSharp06</code></li>
+<li><code>System-CSharp07</code></li>
+<li><code>System-CSharp08</code></li>
 </ul>
 <h2 id="unavailable-system-capabilities">Unavailable System Capabilities</h2>
 <p>The following are listed just to clarify that they currently don't exist in DNN and
 probably cannot be added in any feasible way.</p>
 <ul>
-<li><code>SystemCapability-CSharp08</code> .net 3 (core)</li>
-<li><code>SystemCapability-CSharp09</code> .net 5 (core)</li>
-<li><code>SystemCapability-CSharp10</code> .net 6 (core)</li>
-<li><code>SystemCapability-CSharp11</code> .net 7 (core)</li>
-<li><code>SystemCapability-CSharp12</code> .net 8 (core)</li>
-<li><code>SystemCapability-NetCore</code> Dnn is .net Framework only as of now</li>
-<li><code>SystemCapability-Blazor</code> requires .net Core v3+; works in Oqtane</li>
+<li><code>System-CSharp09</code> .net 5 (core)</li>
+<li><code>System-CSharp10</code> .net 6 (core)</li>
+<li><code>System-CSharp11</code> .net 7 (core)</li>
+<li><code>System-CSharp12</code> .net 8 (core)</li>
+<li><code>System-NetCore</code> Dnn is .net Framework only as of now</li>
+<li><code>System-Blazor</code> requires .net Core v3+; works in Oqtane</li>
 </ul>
 <hr>
 <p>Shortlink: <a href="https://go.2sic.org/dnn-syscap">https://go.2sic.org/dnn-syscap</a></p>

diff --git a/docs/abyss/platforms/oqtane/system-features.html b/docs/abyss/platforms/oqtane/system-features.html
@@ -112,7 +112,7 @@ <h1 id="oqtane-system-capabilities">Oqtane System Capabilities</h1>
 Others can be installed later on, as needed.</p>
 <p>Sometimes you may install an App which requires an additional capability.
 This page should guide you through installing them if you're stuck.
-Look for the code you received, such as <code>SystemCapability-DataSource-SharePoint</code> to find the instruction.</p>
+Look for the code you received, such as <code>System-DataSource-SharePoint</code> to find the instruction.</p>
 <h2 id="additional-system-capabilities">Additional System Capabilities</h2>
 <p>The following are are capabilities which may or may not be pre-installed.</p>
 <div class="NOTE">
@@ -122,21 +122,21 @@ <h5>Note</h5>
 <h2 id="preinstalled-system-capabilities">Preinstalled System Capabilities</h2>
 <p>The following are always available in every Dnn:</p>
 <ul>
-<li><code>SystemCapability-NetCore</code></li>
-<li><code>SystemCapability-Razor</code></li>
-<li><code>SystemCapability-Blazor</code></li>
-<li><code>SystemCapability-CSharp07</code></li>
-<li><code>SystemCapability-CSharp08</code></li>
-<li><code>SystemCapability-CSharp09</code></li>
-<li><code>SystemCapability-CSharp10</code></li>
-<li><code>SystemCapability-CSharp11</code> .net 7 (core) - Oqtane 4</li>
+<li><code>System-NetCore</code></li>
+<li><code>System-Razor</code></li>
+<li><code>System-Blazor</code></li>
+<li><code>System-CSharp07</code></li>
+<li><code>System-CSharp08</code></li>
+<li><code>System-CSharp09</code></li>
+<li><code>System-CSharp10</code></li>
+<li><code>System-CSharp11</code> .net 7 (core) - Oqtane 4</li>
 </ul>
 <h2 id="unavailable-system-capabilities">Unavailable System Capabilities</h2>
 <p>The following are listed just to clarify that they currently don't exist in DNN and
 probably cannot be added in any feasible way.</p>
 <ul>
-<li><code>SystemCapability-CSharp12</code> .net 8 (core) - wait for Oqtane 5</li>
-<li><code>SystemCapability-NetFramework</code> Oqtane is .net Core only</li>
+<li><code>System-CSharp12</code> .net 8 (core) - wait for Oqtane 5</li>
+<li><code>System-NetFramework</code> Oqtane is .net Core only</li>
 </ul>
 <hr>
 <p>Shortlink: <a href="https://go.2sic.org/oqt-syscap">https://go.2sic.org/oqt-syscap</a></p>

diff --git a/docs/abyss/platforms/system-features.html b/docs/abyss/platforms/system-features.html
@@ -110,15 +110,16 @@ <h1 id="system-features-">System Features 🌟</h1>
 
 <p>All platforms come with a lot of features pre-installed.
 Others can be installed later on, as needed.</p>
+<p>You probably arrived here, because you saw a warning similar to this:</p>
+<img src="../../pages/abyss/platforms/assets/sys-features-warning-missing.jpg" class="full-width">
 <p>To find out how to add features, check the section of your platform:</p>
 <ul>
 <li>☢️ <a class="xref" href="dnn/system-features.html">DNN</a></li>
 <li>🩸 <a class="xref" href="oqtane/system-features.html">Oqtane</a></li>
 </ul>
 <h2 id="alternative-configure-apps-to-not-request-said-features">Alternative: Configure Apps to not Request said Features</h2>
-<p>You probably arrived here because an App you installed requires a feature which is not installed.</p>
-<img src="../../pages/abyss/platforms/assets/sys-features-warning-missing.jpg" class="full-width">
-<p>If you can't install it and want to disable the warning to see what you can do about it,
+<p>If the feature was only required by the App configuration, you can also disable that warning.
+You would do this if you can't install it and want to disable the warning to see what you can do about it,
 we've created a checklist for this:</p>
 <iframe src="https://azing.org/2sxc/r/cXiefhIX?embed=1" width="100%" height="400" frameborder="0" allowfullscreen="" style="box-shadow: 0 1px 3px rgba(60,64,67,.3), 0 4px 8px 3px rgba(60,64,67,.15)"></iframe>
 <h2 id="history">History</h2>