Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add page for highlighted references #245

Open
wants to merge 15 commits into
base: main
Choose a base branch
from
2 changes: 2 additions & 0 deletions _quarto.yml
Original file line number Diff line number Diff line change
Expand Up @@ -45,10 +45,12 @@ book:
- chapters/rewriting-history.qmd
- misc/exercises.qmd
- misc/cheatsheet.qmd
- misc/highlighted_references.qmd
lnnrtwttkhn marked this conversation as resolved.
Show resolved Hide resolved
- misc/courses.qmd
- misc/references.qmd
- misc/acknowledgements.qmd
- misc/contributing.qmd
# - misc/style-guide.qmd
page-navigation: true
back-to-top-navigation: true
# side navigation (https://quarto.org/docs/websites/website-navigation.html#side-navigation):
Expand Down
46 changes: 46 additions & 0 deletions misc/highlighted_references.qmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
---
author: ""
---

# Suggested resources {.unnumbered}

## Git for beginners

### Pro Git

The Pro Git book is a standard resource for learning Git, offering a comprehensive and in-depth guide to version control with Git.
Written by Scott Chacon and Ben Straub, the book covers everything from the basics of Git to advanced topics like branching strategies, workflows, and Git internals.
The book is available for free online, making it an excellent resource for anyone looking to deepen their understanding of Git.
However, the Pro Git book can be dense, and some sections may feel overwhelming for newcomers. Additionally, while it’s very thorough, users looking for quick, specific answers might find the book's extensive coverage a bit too detailed.
Despite these drawbacks, the Pro Git book is one of the best resources available for mastering Git.

```{r}
#| eval: true
#| echo: false
#| message: false
#| warning: false
#| output: asis
bibtexkeys = c("chacon2014")
knitr::kable(ref_table(bibtexkeys), format = "markdown")
```

## GitHub

### Official GitHub documentation

The official GitHub resources are essential for anyone working with Git and GitHub.
They offer clear, detailed guidance on using GitHub for version control, collaboration, and project management, covering everything from basic Git commands to advanced features like Actions, Pull Requests, and Issues.
The documentation is well-organized and user-friendly.
Regular updates ensure that the content stays relevant with the latest GitHub features and best practices.
A downside is that the documentation can sometimes be overwhelming due to its depth and the wide range of topics it covers.

```{r}
#| eval: true
#| echo: false
#| message: false
#| warning: false
#| output: asis
bibtexkeys = c("GitHub2023")
knitr::kable(ref_table(bibtexkeys), format = "markdown")
```

7 changes: 6 additions & 1 deletion misc/references.qmd
Original file line number Diff line number Diff line change
@@ -1,4 +1,9 @@
# References {.unnumbered}
---
author: ""
title-block-style: none
---

# Complete references {.unnumbered}

::: {#refs}
:::
2 changes: 1 addition & 1 deletion references.bib
Original file line number Diff line number Diff line change
Expand Up @@ -168,7 +168,7 @@ @book{GitHub2023
year = {2023},
publisher = {GitHub},
url = {https://docs.github.com/en},
note = {License: \href{https://creativecommons.org/licenses/by-nc/4.0/}{CC BY-NC 4.0}. Source: \href{https://docs.github.com/en}{https://docs.github.com/en}}
note = {License: \href{https://creativecommons.org/licenses/by-nc/4.0/}{CC BY-NC 4.0}. Source: \url{https://docs.github.com/en}. Website: \url{https://docs.github.com/en}}
}

@article{blischak2016,
Expand Down
Loading