Built site for gh-pages

r-devel · Jul 29, 2024 · 71a4068 · 71a4068
1 parent 5eea4b1
commit 71a4068
Show file tree

Hide file tree

Showing 5 changed files with 115 additions and 5 deletions.
diff --git a/.nojekyll b/.nojekyll
@@ -1 +1 @@
-3a700d9d
+0240d628
diff --git a/description_issues.html b/description_issues.html
@@ -213,6 +213,22 @@ <h2 id="toc-title">On this page</h2>
   <li><a href="#details" id="toc-details" class="nav-link" data-scroll-target="#details">Details</a></li>
   </ul></li>
   </ul></li>
+  <li><a href="#explaining-acronyms" id="toc-explaining-acronyms" class="nav-link" data-scroll-target="#explaining-acronyms">Explaining Acronyms</a>
+  <ul class="collapse">
+  <li><a href="#problem-1" id="toc-problem-1" class="nav-link" data-scroll-target="#problem-1">Problem</a></li>
+  <li><a href="#solution-1" id="toc-solution-1" class="nav-link" data-scroll-target="#solution-1">Solution</a>
+  <ul class="collapse">
+  <li><a href="#details-1" id="toc-details-1" class="nav-link" data-scroll-target="#details-1">Details</a></li>
+  </ul></li>
+  </ul></li>
+  <li><a href="#license-files" id="toc-license-files" class="nav-link" data-scroll-target="#license-files">LICENSE files</a>
+  <ul class="collapse">
+  <li><a href="#problem-2" id="toc-problem-2" class="nav-link" data-scroll-target="#problem-2">Problem</a></li>
+  <li><a href="#solution-2" id="toc-solution-2" class="nav-link" data-scroll-target="#solution-2">Solution</a>
+  <ul class="collapse">
+  <li><a href="#details-2" id="toc-details-2" class="nav-link" data-scroll-target="#details-2">Details</a></li>
+  </ul></li>
+  </ul></li>
   </ul>
 </nav>
     </div>
@@ -255,6 +271,50 @@ <h3 class="anchored" data-anchor-id="details">Details</h3>
     read rectangular data (like 'csv', 'tsv', and 'fwf').  It is designed
     to flexibly parse many types of data found in the wild, while still
     cleanly failing when data unexpectedly changes.</code></pre>
+</section>
+</section>
+</section>
+<section id="explaining-acronyms" class="level1">
+<h1>Explaining Acronyms</h1>
+<section id="problem-1" class="level2">
+<h2 class="anchored" data-anchor-id="problem-1">Problem</h2>
+<p>You are using acronyms in your DESCRIPTION file or they are flagged by the automatic spell check.</p>
+</section>
+<section id="solution-1" class="level2">
+<h2 class="anchored" data-anchor-id="solution-1">Solution</h2>
+<p>Document all non-obvious acronyms in the <a href="https://usethis.r-lib.org/reference/use_cran_comments.html">cran-comments.md</a> file to facilitate the CRAN team review.</p>
+<section id="details-1" class="level3">
+<h3 class="anchored" data-anchor-id="details-1">Details</h3>
+<p>Most acronyms that are not widely known should be explained. For example, you don’t have to explain <em>OLS</em>, <em>SEO</em>, or <em>DNA</em> but explanations should be provided for: <em>MEFM</em> or <em>OCCDS</em>. If you are unsure of the acronyms common knowledge, please document all acronyms in the package.</p>
+</section>
+</section>
+</section>
+<section id="license-files" class="level1">
+<h1>LICENSE files</h1>
+<p>Same goes for MIT-License files with wrongly specified copyright holders. Surprisingly often, package authors write “[packagename] authors” (which is fine) but still list an old/outdated packagename.</p>
+<section id="problem-2" class="level2">
+<h2 class="anchored" data-anchor-id="problem-2">Problem</h2>
+<p>A file is referenced in the DESCRIPTION for License.</p>
+</section>
+<section id="solution-2" class="level2">
+<h2 class="anchored" data-anchor-id="solution-2">Solution</h2>
+<p>Remove the reference <code>+ file LICENSE</code></p>
+<section id="details-2" class="level3">
+<h3 class="anchored" data-anchor-id="details-2">Details</h3>
+<p>Most licenses don’t need an additional file as these are part of R.</p>
+<div class="callout callout-style-default callout-tip callout-titled">
+<div class="callout-header d-flex align-content-center">
+<div class="callout-icon-container">
+<i class="callout-icon"></i>
+</div>
+<div class="callout-title-container flex-fill">
+Tip
+</div>
+</div>
+<div class="callout-body-container callout-body">
+<p>All licenses must be <a href="https://svn.r-project.org/R/trunk/share/licenses/license.db">FOSS</a>.</p>
+</div>
+</div>
 
 
 </section>

diff --git a/search.json b/search.json
@@ -119,6 +119,50 @@
       "DESCRIPTION file Issues"
     ]
   },
+  {
+    "objectID": "description_issues.html#problem-1",
+    "href": "description_issues.html#problem-1",
+    "title": "DESCRIPTION file Issues",
+    "section": "Problem",
+    "text": "Problem\nYou are using acronyms in your DESCRIPTION file or they are flagged by the automatic spell check.",
+    "crumbs": [
+      "DESCRIPTION file Issues",
+      "DESCRIPTION file Issues"
+    ]
+  },
+  {
+    "objectID": "description_issues.html#solution-1",
+    "href": "description_issues.html#solution-1",
+    "title": "DESCRIPTION file Issues",
+    "section": "Solution",
+    "text": "Solution\nDocument all non-obvious acronyms in the cran-comments.md file to facilitate the CRAN team review.\n\nDetails\nMost acronyms that are not widely known should be explained. For example, you don’t have to explain OLS, SEO, or DNA but explanations should be provided for: MEFM or OCCDS. If you are unsure of the acronyms common knowledge, please document all acronyms in the package.",
+    "crumbs": [
+      "DESCRIPTION file Issues",
+      "DESCRIPTION file Issues"
+    ]
+  },
+  {
+    "objectID": "description_issues.html#problem-2",
+    "href": "description_issues.html#problem-2",
+    "title": "DESCRIPTION file Issues",
+    "section": "Problem",
+    "text": "Problem\nA file is referenced in the DESCRIPTION for License.",
+    "crumbs": [
+      "DESCRIPTION file Issues",
+      "DESCRIPTION file Issues"
+    ]
+  },
+  {
+    "objectID": "description_issues.html#solution-2",
+    "href": "description_issues.html#solution-2",
+    "title": "DESCRIPTION file Issues",
+    "section": "Solution",
+    "text": "Solution\nRemove the reference + file LICENSE\n\nDetails\nMost licenses don’t need an additional file as these are part of R.\n\n\n\n\n\n\nTip\n\n\n\nAll licenses must be FOSS.",
+    "crumbs": [
+      "DESCRIPTION file Issues",
+      "DESCRIPTION file Issues"
+    ]
+  },
   {
     "objectID": "general_issues.html",
     "href": "general_issues.html",

diff --git a/sitemap.xml b/sitemap.xml
@@ -2,23 +2,23 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://r-devel.github.io/cran-cookbook/docs_issues.html</loc>
-    <lastmod>2024-07-18T13:32:44.105Z</lastmod>
+    <lastmod>2024-07-25T22:24:02.874Z</lastmod>
   </url>
   <url>
     <loc>https://r-devel.github.io/cran-cookbook/index.html</loc>
     <lastmod>2024-06-27T15:03:59.376Z</lastmod>
   </url>
   <url>
     <loc>https://r-devel.github.io/cran-cookbook/description_issues.html</loc>
-    <lastmod>2024-07-18T13:32:40.149Z</lastmod>
+    <lastmod>2024-07-25T22:40:01.712Z</lastmod>
   </url>
   <url>
     <loc>https://r-devel.github.io/cran-cookbook/general_issues.html</loc>
-    <lastmod>2024-06-27T15:03:59.376Z</lastmod>
+    <lastmod>2024-07-25T22:24:02.874Z</lastmod>
   </url>
   <url>
     <loc>https://r-devel.github.io/cran-cookbook/code_issues.html</loc>
-    <lastmod>2024-06-27T15:03:59.374Z</lastmod>
+    <lastmod>2024-07-25T22:24:02.873Z</lastmod>
   </url>
   <url>
     <loc>https://r-devel.github.io/cran-cookbook/about.html</loc>

diff --git a/style.css b/style.css
@@ -0,0 +1,6 @@
+hr {
+    border: none;
+    height: 5px;
+    color: blue;
+    background-color: blue;
+}