Updated the website

Author: tony-aw

README.md

@@ -339,6 +339,13 @@ Not using external libraries brings a number of advantages:
 - Avoid wasting time, memory and computing resources for translating
   between language structures.
 - Ensure consistent behaviour with the rest of ‘R’.
+- Access to CRAN’s quality control (no comparable quality control
+  organization exists for most other programming languages).
+
+See the [Other
+Packages](https://tony-aw.github.io/broadcast/about/d_other_pkgs.html)
+page for more details on the above points regarding the advantages of
+minimizing dependencies.
 
 
 

README.qmd

@@ -251,6 +251,9 @@ Not using external libraries brings a number of advantages:
 -   Avoid dependency hell.
 -   Avoid wasting time, memory and computing resources for translating between language structures.
 -   Ensure consistent behaviour with the rest of 'R'.
+-   Access to CRAN's quality control (no comparable quality control organization exists for most other programming languages).
+
+See the [Other Packages](https://tony-aw.github.io/broadcast/about/d_other_pkgs.html) page for more details on the above points regarding the advantages of minimizing dependencies.
 
 
 

docs/about/a_acknowledgements.html

@@ -146,7 +146,7 @@
         <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../about/d_other_pkgs.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Other packages</span></a>
+ <span class="menu-text">Other Packages</span></a>
   </div>
 </li>
         <li class="sidebar-item">

docs/about/b_NEWS.html

@@ -146,7 +146,7 @@
         <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../about/d_other_pkgs.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Other packages</span></a>
+ <span class="menu-text">Other Packages</span></a>
   </div>
 </li>
         <li class="sidebar-item">

docs/about/c_LICENSE.html

@@ -146,7 +146,7 @@
         <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../about/d_other_pkgs.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Other packages</span></a>
+ <span class="menu-text">Other Packages</span></a>
   </div>
 </li>
         <li class="sidebar-item">

docs/about/d_other_pkgs.html

@@ -7,7 +7,7 @@
 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
 
 
-<title>package broadcast - Other packages</title>
+<title>package broadcast - Other Packages</title>
 <style>
 code{white-space: pre-wrap;}
 span.smallcaps{font-variant: small-caps;}
@@ -110,7 +110,7 @@
       <button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar,#quarto-sidebar-glass" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">
         <i class="bi bi-layout-text-sidebar-reverse"></i>
       </button>
-      <nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../about/d_other_pkgs.html">Other packages</a></li></ol></nav>
+      <nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../about/d_other_pkgs.html">Other Packages</a></li></ol></nav>
       <a class="flex-grow-1" role="button" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar,#quarto-sidebar-glass" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }">      
       </a>
     </div>
@@ -146,7 +146,7 @@
         <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../about/d_other_pkgs.html" class="sidebar-item-text sidebar-link active">
- <span class="menu-text">Other packages</span></a>
+ <span class="menu-text">Other Packages</span></a>
   </div>
 </li>
         <li class="sidebar-item">
@@ -178,7 +178,7 @@ <h2 id="toc-title">On this page</h2>
 
   <ul>
   <li><a href="#alternatives-to-broadcast" id="toc-alternatives-to-broadcast" class="nav-link active" data-scroll-target="#alternatives-to-broadcast">Alternatives to ‘broadcast’</a></li>
-  <li><a href="#the-tinyverse" id="toc-the-tinyverse" class="nav-link" data-scroll-target="#the-tinyverse">The ’tinyverse</a></li>
+  <li><a href="#the-tinyverse" id="toc-the-tinyverse" class="nav-link" data-scroll-target="#the-tinyverse">The ‘tinyverse’</a></li>
   </ul>
 <div class="toc-actions"><div><i class="bi bi-github"></i></div><div class="action-links"><p><a href="https://github.com/tony-aw/broadcast/issues/new" class="toc-action">Report an issue</a></p></div></div></nav>
     </div>
@@ -187,7 +187,7 @@ <h2 id="toc-title">On this page</h2>
 
 <header id="title-block-header" class="quarto-title-block default">
 <div class="quarto-title">
-<h1 class="title">Other packages</h1>
+<h1 class="title">Other Packages</h1>
 </div>
 
 
@@ -213,12 +213,13 @@ <h1>Alternatives to ‘broadcast’</h1>
 <li><strong>Wasteful translations</strong>: Using libraries from other languages, such as ‘xtensor’ (‘C++’) or ‘Numpy’ (‘Python’) means that - at some point - one needs to convert between the structure of <svg aria-hidden="true" role="img" viewbox="0 0 581 512" style="height:1em;width:1.13em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:currentColor;overflow:visible;position:relative;"><path d="M581 226.6C581 119.1 450.9 32 290.5 32S0 119.1 0 226.6C0 322.4 103.3 402 239.4 418.1V480h99.1v-61.5c24.3-2.7 47.6-7.4 69.4-13.9L448 480h112l-67.4-113.7c54.5-35.4 88.4-84.9 88.4-139.7zm-466.8 14.5c0-73.5 98.9-133 220.8-133s211.9 40.7 211.9 133c0 50.1-26.5 85-70.3 106.4-2.4-1.6-4.7-2.9-6.4-3.7-10.2-5.2-27.8-10.5-27.8-10.5s86.6-6.4 86.6-92.7-90.6-87.9-90.6-87.9h-199V361c-74.1-21.5-125.2-67.1-125.2-119.9zm225.1 38.3v-55.6c57.8 0 87.8-6.8 87.8 27.3 0 36.5-38.2 28.3-87.8 28.3zm-.9 72.5H365c10.8 0 18.9 11.7 24 19.2-16.1 1.9-33 2.8-50.6 2.9v-22.1z"></path></svg> to that of the other language, and vice-versa, which wastes precious time, memory, and power.</li>
 <li><strong>Inconsistent behaviour</strong>: Using libraries from other languages also means one cannot always guarantee consistent behaviour for some operations.<br>
 For example: both ‘Numpy’ and ‘xtensor’ have only limited support for missing values, whereas <svg aria-hidden="true" role="img" viewbox="0 0 581 512" style="height:1em;width:1.13em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:currentColor;overflow:visible;position:relative;"><path d="M581 226.6C581 119.1 450.9 32 290.5 32S0 119.1 0 226.6C0 322.4 103.3 402 239.4 418.1V480h99.1v-61.5c24.3-2.7 47.6-7.4 69.4-13.9L448 480h112l-67.4-113.7c54.5-35.4 88.4-84.9 88.4-139.7zm-466.8 14.5c0-73.5 98.9-133 220.8-133s211.9 40.7 211.9 133c0 50.1-26.5 85-70.3 106.4-2.4-1.6-4.7-2.9-6.4-3.7-10.2-5.2-27.8-10.5-27.8-10.5s86.6-6.4 86.6-92.7-90.6-87.9-90.6-87.9h-199V361c-74.1-21.5-125.2-67.1-125.2-119.9zm225.1 38.3v-55.6c57.8 0 87.8-6.8 87.8 27.3 0 36.5-38.2 28.3-87.8 28.3zm-.9 72.5H365c10.8 0 18.9 11.7 24 19.2-16.1 1.9-33 2.8-50.6 2.9v-22.1z"></path></svg> supports missing values for both atomic and recursive array/vector types (except type of ‘Raw’).</li>
+<li><strong>Access to CRAN’s quality control</strong>: ‘R’ is unique in that it has access to CRAN’s quality control; most other languages (including Python) don’t have a real comparable organization like CRAN.</li>
 </ul>
 <p>Since the ‘broadcast’ package does not rely on any external library, other than linking to ‘Rcpp’, ‘broadcast’ avoids all of the above issues.</p>
 <p>&nbsp;</p>
 </section>
 <section id="the-tinyverse" class="level1">
-<h1>The ’tinyverse</h1>
+<h1>The ‘tinyverse’</h1>
 <p>The ‘broadcast’ package adheres to the ‘tinyverse’ philosophy (not to be confused with the ‘tidyverse’), which is the programming philosophy to primarily minimize dependencies. ‘broadcast’ also belongs to the <a href="https://github.com/fastverse/fastverse">fastverse</a>, which is a collection of packages aimed at keep code fast and efficient.</p>
 <p>Packages that belong to the ‘fastverse’ can be found listed on the dedicated GitHub page:<br>
 <a href="https://github.com/fastverse/fastverse">https://github.com/fastverse/fastverse</a>.</p>

docs/about/e_benchmarks_numpy.html

@@ -199,7 +199,7 @@
         <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../about/d_other_pkgs.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Other packages</span></a>
+ <span class="menu-text">Other Packages</span></a>
   </div>
 </li>
         <li class="sidebar-item">
@@ -427,6 +427,8 @@ <h1>Results</h1>
 <h1>Conclusion &amp; Discussion</h1>
 <p>It appears that ‘broadcast’ is slightly faster than ‘Numpy’, though the differences in the computation times between ‘broadcast’ and ‘Numpy’ are rather small. It seems reasonable to conclude that, in general, ‘broadcast’ and ‘Numpy’ have somewhat similar speeds. It can also be observed that ‘broadcast’ has a bit more spread/variation in its computation time than ‘Numpy’.</p>
 <p>&nbsp;</p>
+<p>The benchmarks shown here involved rather large arrays (90 to 100 million elements). These benchmarks thus focussed on the core computation time, and not so much on the overhead involved.</p>
+<p>&nbsp;</p>
 <p>As stated earlier, comparing benchmarks between <svg aria-hidden="true" role="img" viewbox="0 0 581 512" style="height:1em;width:1.13em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:currentColor;overflow:visible;position:relative;"><path d="M581 226.6C581 119.1 450.9 32 290.5 32S0 119.1 0 226.6C0 322.4 103.3 402 239.4 418.1V480h99.1v-61.5c24.3-2.7 47.6-7.4 69.4-13.9L448 480h112l-67.4-113.7c54.5-35.4 88.4-84.9 88.4-139.7zm-466.8 14.5c0-73.5 98.9-133 220.8-133s211.9 40.7 211.9 133c0 50.1-26.5 85-70.3 106.4-2.4-1.6-4.7-2.9-6.4-3.7-10.2-5.2-27.8-10.5-27.8-10.5s86.6-6.4 86.6-92.7-90.6-87.9-90.6-87.9h-199V361c-74.1-21.5-125.2-67.1-125.2-119.9zm225.1 38.3v-55.6c57.8 0 87.8-6.8 87.8 27.3 0 36.5-38.2 28.3-87.8 28.3zm-.9 72.5H365c10.8 0 18.9 11.7 24 19.2-16.1 1.9-33 2.8-50.6 2.9v-22.1z"></path></svg> and ‘Python’ should be taken with a grain of salt. I am open for suggestions on how to improve the computation time comparisons between ‘broadcast’ and ‘Numpy’, and make them more fair (so feel free to post suggestions on the GitHub Discussions page).</p>
 <p>&nbsp;</p>
 </section>

docs/about/f_benchmarks_other.html

@@ -180,7 +180,7 @@
         <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../about/d_other_pkgs.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Other packages</span></a>
+ <span class="menu-text">Other Packages</span></a>
   </div>
 </li>
         <li class="sidebar-item">

docs/about/g_unit_test_covr.html

@@ -180,7 +180,7 @@
         <li class="sidebar-item">
   <div class="sidebar-item-container"> 
   <a href="../about/d_other_pkgs.html" class="sidebar-item-text sidebar-link">
- <span class="menu-text">Other packages</span></a>
+ <span class="menu-text">Other Packages</span></a>
   </div>
 </li>
         <li class="sidebar-item">

docs/index.html

@@ -373,7 +373,9 @@ <h2 class="anchored" data-anchor-id="why-use-broadcast">Why use ‘broadcast’<
 <li>Avoid dependency hell.</li>
 <li>Avoid wasting time, memory and computing resources for translating between language structures.</li>
 <li>Ensure consistent behaviour with the rest of <svg aria-hidden="true" role="img" viewbox="0 0 581 512" style="height:1em;width:1.13em;vertical-align:-0.125em;margin-left:auto;margin-right:auto;font-size:inherit;fill:currentColor;overflow:visible;position:relative;"><path d="M581 226.6C581 119.1 450.9 32 290.5 32S0 119.1 0 226.6C0 322.4 103.3 402 239.4 418.1V480h99.1v-61.5c24.3-2.7 47.6-7.4 69.4-13.9L448 480h112l-67.4-113.7c54.5-35.4 88.4-84.9 88.4-139.7zm-466.8 14.5c0-73.5 98.9-133 220.8-133s211.9 40.7 211.9 133c0 50.1-26.5 85-70.3 106.4-2.4-1.6-4.7-2.9-6.4-3.7-10.2-5.2-27.8-10.5-27.8-10.5s86.6-6.4 86.6-92.7-90.6-87.9-90.6-87.9h-199V361c-74.1-21.5-125.2-67.1-125.2-119.9zm225.1 38.3v-55.6c57.8 0 87.8-6.8 87.8 27.3 0 36.5-38.2 28.3-87.8 28.3zm-.9 72.5H365c10.8 0 18.9 11.7 24 19.2-16.1 1.9-33 2.8-50.6 2.9v-22.1z"></path></svg>.</li>
+<li>Access to CRAN’s quality control (no comparable quality control organization exists for most other programming languages).</li>
 </ul>
+<p>See the <a href="https://tony-aw.github.io/broadcast/about/d_other_pkgs.html">Other Packages</a> page for more details on the above points regarding the advantages of minimizing dependencies.</p>
 <p>&nbsp;</p>
 <p><strong>Tested</strong></p>
 <p>The ‘broadcast’ package is frequently checked using a large suite of unit tests via the <a href="https://github.com/markvanderloo/tinytest">tinytest</a> package. These tests have a <a href="https://tony-aw.github.io/broadcast/about/g_unit_test_covr.html">coverage</a> of over 90%. So the chance of a function from this package breaking completely is relatively low.</p>