Skip to content

Commit

Permalink
update R-ladies slack link
Browse files Browse the repository at this point in the history
  • Loading branch information
privefl committed Oct 3, 2024
1 parent 8ba4898 commit 5675c8c
Show file tree
Hide file tree
Showing 6 changed files with 25 additions and 30 deletions.
6 changes: 5 additions & 1 deletion docs/404.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<title>Page not found | Advanced R Course</title>
<meta name="description" content="This contains materials for the Advanced R course of the doctoral school of Grenoble, France." />
<meta name="generator" content="bookdown 0.29 and GitBook 2.6.7" />
<meta name="generator" content="bookdown 0.40 and GitBook 2.6.7" />

<meta property="og:title" content="Page not found | Advanced R Course" />
<meta property="og:type" content="book" />
Expand Down Expand Up @@ -129,6 +129,10 @@
code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
</style>

<style type="text/css">

div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
</style>

<link rel="stylesheet" href="style.css" type="text/css" />
</head>
Expand Down
27 changes: 9 additions & 18 deletions docs/good-practices.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<title>Chapter 2 Good practices | Advanced R Course</title>
<meta name="description" content="This contains materials for the Advanced R course of the doctoral school of Grenoble, France." />
<meta name="generator" content="bookdown 0.29 and GitBook 2.6.7" />
<meta name="generator" content="bookdown 0.40 and GitBook 2.6.7" />

<meta property="og:title" content="Chapter 2 Good practices | Advanced R Course" />
<meta property="og:type" content="book" />
Expand Down Expand Up @@ -129,6 +129,10 @@
code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
</style>

<style type="text/css">

div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
</style>

<link rel="stylesheet" href="style.css" type="text/css" />
</head>
Expand Down Expand Up @@ -249,14 +253,15 @@
<li class="chapter" data-level="6" data-path="packages.html"><a href="packages.html"><i class="fa fa-check"></i><b>6</b> Packages</a>
<ul>
<li class="chapter" data-level="6.1" data-path="packages.html"><a href="packages.html#resources"><i class="fa fa-check"></i><b>6.1</b> Resources</a></li>
<li class="chapter" data-level="6.2" data-path="packages.html"><a href="packages.html#project-exercise"><i class="fa fa-check"></i><b>6.2</b> Project exercise</a></li>
<li class="chapter" data-level="6.2" data-path="packages.html"><a href="packages.html#package-exercise"><i class="fa fa-check"></i><b>6.2</b> Package exercise</a></li>
<li class="chapter" data-level="6.3" data-path="packages.html"><a href="packages.html#pkg-start"><i class="fa fa-check"></i><b>6.3</b> Quick start</a></li>
<li class="chapter" data-level="6.4" data-path="packages.html"><a href="packages.html#pkg-basics"><i class="fa fa-check"></i><b>6.4</b> Basic stuff</a>
<li class="chapter" data-level="6.4" data-path="packages.html"><a href="packages.html#pkg-basics"><i class="fa fa-check"></i><b>6.4</b> Package basics</a>
<ul>
<li class="chapter" data-level="6.4.1" data-path="packages.html"><a href="packages.html#description-file"><i class="fa fa-check"></i><b>6.4.1</b> <em>DESCRIPTION</em> file</a></li>
<li class="chapter" data-level="6.4.2" data-path="packages.html"><a href="packages.html#r-code"><i class="fa fa-check"></i><b>6.4.2</b> R code</a></li>
<li class="chapter" data-level="6.4.3" data-path="packages.html"><a href="packages.html#documentation"><i class="fa fa-check"></i><b>6.4.3</b> Documentation</a></li>
<li class="chapter" data-level="6.4.4" data-path="packages.html"><a href="packages.html#namespace-file"><i class="fa fa-check"></i><b>6.4.4</b> <em>NAMESPACE</em> file</a></li>
<li class="chapter" data-level="6.4.5" data-path="packages.html"><a href="packages.html#exercise-2"><i class="fa fa-check"></i><b>6.4.5</b> Exercise</a></li>
</ul></li>
<li class="chapter" data-level="6.5" data-path="packages.html"><a href="packages.html#good-practices-1"><i class="fa fa-check"></i><b>6.5</b> Good practices</a>
<ul>
Expand Down Expand Up @@ -577,7 +582,7 @@ <h3><span class="header-section-number">2.4.2</span> External help<a href="good-
<p><img src="images/meme-SO.jpg" width="25%" style="display: block; margin: auto;" /></p>
<p>You can ask questions on Stack Overflow (using the tag <code>r</code>). You need to <a href="https://stackoverflow.com/questions/5963269/how-to-make-a-great-r-reproducible-example">make a great R reproducible example</a> if you want your question to be answered. Sometimes, while making this minimal reproducible example, you end up understanding and solving the issue on your own.</p>
<p>If you are confident enough with your R skills, you can take the next step and <a href="https://stackoverflow.com/unanswered/tagged/r?tab=newest">answer questions on Stack Overflow</a>. It’s a good way to increase your skills, or just to <a href="https://privefl.github.io/blog/one-month-as-a-procrastinator-on-stack-overflow/">procrastinate while writing a scientific manuscript</a>.</p>
<p>You can also join communities, e.g. <a href="https://join.slack.com/t/r-grrr/shared_invite/enQtMzI4MzgwNTc4OTAxLWZlOGZiZTBiMWU0NDQ3OTYzOGE1YThiODgwZWNhNWEyYjI4ZDJiNmNhY2YyYWI5YzFiOTFkNDYxYzkwODUwNWM">join the French-speaking R community</a> or <a href="https://rladies-community-slack.herokuapp.com/">join the R-Ladies community</a> on Slack. These are generally much friendlier and welcoming spaces compared to Stack Overflow.</p>
<p>You can also join communities, e.g. <a href="https://join.slack.com/t/r-grrr/shared_invite/enQtMzI4MzgwNTc4OTAxLWZlOGZiZTBiMWU0NDQ3OTYzOGE1YThiODgwZWNhNWEyYjI4ZDJiNmNhY2YyYWI5YzFiOTFkNDYxYzkwODUwNWM">join the French-speaking R community</a> or <a href="https://airtable.com/appJZFYABfCIdPYMR/pagw7FJB5tm2UQ55o/form">join the R-Ladies community</a> on Slack. These are generally much friendlier and welcoming spaces compared to Stack Overflow.</p>

</div>
</div>
Expand Down Expand Up @@ -642,20 +647,6 @@ <h3><span class="header-section-number">2.4.2</span> External help<a href="good-
});
</script>

<!-- dynamically load mathjax for compatibility with self-contained -->
<script>
(function () {
var script = document.createElement("script");
script.type = "text/javascript";
var src = "true";
if (src === "" || src === "true") src = "https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.9/latest.js?config=TeX-MML-AM_CHTML";
if (location.protocol !== "file:")
if (/^https?:/.test(src))
src = src.replace(/^https?:/, '');
script.src = src;
document.getElementsByTagName("head")[0].appendChild(script);
})();
</script>
</body>

</html>
16 changes: 8 additions & 8 deletions docs/good-practices.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ Most infix operators (`==`, `+`, `-`, `<-`, etc.) are also surrounded by
spaces, except those with relatively high precedence: `^`, `:`, `::`, and `:::`. Always put a space after a comma, and never before (just like in regular English).


```r
``` r
# Good
average <- mean((feet / 12) + inches, na.rm = TRUE)
x <- 1:10
Expand All @@ -44,7 +44,7 @@ base :: sum
Curly braces, `{}`, define the most important hierarchy of R code. To make this hierarchy easy to see, always indent the code inside `{}` by two spaces. This should be automatic in RStudio.


```r
``` r
# Good
if (y < 0 && debug) {
message("y is negative")
Expand Down Expand Up @@ -87,7 +87,7 @@ a separate function. In RStudio -> Tools -> Global Options, set
- Use `<-`, not `=`, for assignment. Keep `=` for parameters.


```r
``` r
# Good
x <- 5
system.time(
Expand All @@ -107,7 +107,7 @@ on the same line.
- Only use `return()` for early returns. Otherwise rely on R to return the result of the last evaluated expression.


```r
``` r
# Good
add_two <- function(x, y) {
x + y
Expand All @@ -122,7 +122,7 @@ add_two <- function(x, y) {
- Use `"`, not `'`, for quoting text. The only exception is when the text already contains double quotes and no single quotes.


```r
``` r
# Good
"Text"
'Text with "quotes"'
Expand Down Expand Up @@ -261,7 +261,7 @@ ssh-add <path_to_public_key>` (cf. [this SO answer](https://stackoverflow.com/a/
A basic solution is to print everything, but it's usually not working well on complex problems. A convenient solution to see all the variables' states in your code is to place some `browser()` from where you want to check the variables' states. To debug functions, `debugonce()` is also very useful.


```r
``` r
my_log <- function(x) log(x - 1)

my_fun <- function(a, b) {
Expand All @@ -284,7 +284,7 @@ my_fun(1, 0)
Try to uncomment `browser()` or use `debugonce(my_fun)`:


```r
``` r
debugonce(my_fun)
my_fun(1, 0)
```
Expand All @@ -306,4 +306,4 @@ You can ask questions on Stack Overflow (using the tag `r`). You need to [make a

If you are confident enough with your R skills, you can take the next step and [answer questions on Stack Overflow](https://stackoverflow.com/unanswered/tagged/r?tab=newest). It's a good way to increase your skills, or just to [procrastinate while writing a scientific manuscript](https://privefl.github.io/blog/one-month-as-a-procrastinator-on-stack-overflow/).

You can also join communities, e.g. [join the French-speaking R community](https://join.slack.com/t/r-grrr/shared_invite/enQtMzI4MzgwNTc4OTAxLWZlOGZiZTBiMWU0NDQ3OTYzOGE1YThiODgwZWNhNWEyYjI4ZDJiNmNhY2YyYWI5YzFiOTFkNDYxYzkwODUwNWM) or [join the R-Ladies community](https://rladies-community-slack.herokuapp.com/) on Slack. These are generally much friendlier and welcoming spaces compared to Stack Overflow.
You can also join communities, e.g. [join the French-speaking R community](https://join.slack.com/t/r-grrr/shared_invite/enQtMzI4MzgwNTc4OTAxLWZlOGZiZTBiMWU0NDQ3OTYzOGE1YThiODgwZWNhNWEyYjI4ZDJiNmNhY2YyYWI5YzFiOTFkNDYxYzkwODUwNWM) or [join the R-Ladies community](https://airtable.com/appJZFYABfCIdPYMR/pagw7FJB5tm2UQ55o/form) on Slack. These are generally much friendlier and welcoming spaces compared to Stack Overflow.
2 changes: 1 addition & 1 deletion docs/libs/gitbook-2.6.7/css/plugin-highlight.css
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,7 @@
.book.color-theme-1 .book-body .page-wrapper .page-inner section.normal code {
/*
Orginal Style from ethanschoonover.com/solarized (c) Jeremy Hull <[email protected]>
Original Style from ethanschoonover.com/solarized (c) Jeremy Hull <[email protected]>
*/
/* Solarized Green */
Expand Down
Loading

0 comments on commit 5675c8c

Please sign in to comment.