Skip to content

Commit

Permalink
Merge pull request #297 from NLeSC/add-page-maintainers
Browse files Browse the repository at this point in the history
Move chapter owners to page maintainers
  • Loading branch information
egpbos authored Nov 2, 2023
2 parents 7173301 + ca79bf1 commit 8596f0e
Show file tree
Hide file tree
Showing 12 changed files with 31 additions and 30 deletions.
5 changes: 3 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,9 +45,10 @@ If everything works as it should, ``git add``, ``commit`` and ``push`` like norm

If you have made a significant contribution to the guide, please make sure to add yourself to the `CITATION.cff` file so your name can be included in the list of authors of the guide.

## Chapter Owners
## Page maintainers

To see who is responsible for which part of the guide see [chapter_owners.md](chapter_owners.md).
To see who is responsible for which part of the guide see the maintainer listed at the top of a page.
If you are interested in becoming a chapter owner for a page that is listed as *unmaintained*, please open a pull request to add your name instead of *unmaintained*.

## Create a PDF file

Expand Down
1 change: 0 additions & 1 deletion _sidebar.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,5 @@
* [Fortran](/best_practices/language_guides/fortran.md)
* [Contributing to this Guide](/CONTRIBUTING.md)
* NLeSC specific
* [Chapter Owners](/chapter_owners.md)
* [Access to (Dutch) e-Infrastructure](/nlesc_specific/e-infrastructure/e-infrastructure.md)
* [DAS-5](/nlesc_specific/e-infrastructure/das5.md)
3 changes: 3 additions & 0 deletions best_practices/language_guides/bash.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# Bash

*Page maintainer: Bouwe Andela* [@bouweandela](https://github.com/bouweandela)


Bash is both a command line interface,
also known as a **shell**, and a scripting language.
On most Linux distributions, the Bash shell is the default way of interacting
Expand Down
4 changes: 3 additions & 1 deletion best_practices/language_guides/ccpp.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# C and C++

*Page maintainers: Johan Hidding* [@jhidding](https://github.com/jhidding) *and Patrick Bos* [@egpbos](https://github.com/egpbos)


C++ is one of the hardest languages to learn. Entering a project where C++ coding is needed should not be taken lightly. This guide focusses on tools and documentation for use of C++ in an open-source environment.

### Standards
Expand Down Expand Up @@ -325,4 +328,3 @@ A newer but less mature option is [cldoc](http://jessevdk.github.io/cldoc/).
### Books
* Bjarne Soustrup - The C++ Language
* Scott Meyers - Effective Modern C++

3 changes: 3 additions & 0 deletions best_practices/language_guides/fortran.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# Fortran

*Page maintainer: Gijs van den Oord* [@goord](https://github.com/goord)


**Disclaimer: In general the Netherlands eScience Center does not recommend using Fortran. However, in some cases it is the only viable option, for instance if a project builds upon existing code written in this language. This section will be restricted to Fortran90, which captures majority of Fortran source code.**

The second use case may be extremely performance-critical dense
Expand Down
3 changes: 3 additions & 0 deletions best_practices/language_guides/javascript.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# Getting started

*Page maintainer: Jurriaan Spaaks* [@jspaaks](https://github.com/jspaaks)


To learn about JavaScript, view the presentations by [Douglas Crockford](http://en.wikipedia.org/wiki/Douglas_crockford):

* [Crockford on JavaScript](http://www.youtube.com/playlist?list=PL7664379246A246CB)
Expand Down
4 changes: 4 additions & 0 deletions best_practices/language_guides/languages_overview.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@

*Page maintainer: unmaintained*


This chapter provides practical info on each of the main programming languages of the Netherlands eScience Center.

This info is (on purpose) high level, try to provide "default" options, and mostly link to more info.
Expand Down
2 changes: 2 additions & 0 deletions best_practices/language_guides/opencl_cuda.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# OpenCL & CUDA

*Page maintainer: Alessio Sclocco* [@isazi](https://github.com/isazi)


## Sources for learning
*please add university courses and informative videos*
Expand Down
3 changes: 3 additions & 0 deletions best_practices/language_guides/python.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# Python

*Page maintainer: Patrick Bos* [@egpbos](https://github.com/egpbos)


Python is the "dynamic language of choice" of the Netherlands eScience Center.
We use it for data analysis and data science projects using the SciPy stack and Jupyter notebooks, and for [many other types of projects](https://github.com/NLeSC?language=python): workflow management, visualization, NLP, web-based tools and much more.
It is a good default choice for many kinds of projects due to its generic nature, its large and broad ecosystem of third-party modules and its compact syntax which allows for rapid prototyping.
Expand Down
4 changes: 4 additions & 0 deletions best_practices/language_guides/r.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,8 @@
# What is R?

*Page maintainer: unmaintained*


R is a functional programming language and software environment for statistical computing and graphics: https://www.r-project.org/.

## Philosophy and typical use cases
Expand Down
4 changes: 3 additions & 1 deletion best_practices/user_experience.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@

# User Experience (UX)

*Page maintainer: Jesus Garcia* [@ctwhome](https://github.com/ctwhome)


User Experience Design (UX) is a broad, holistic science that combines many cognitive and brain sciences disciplines like psychology and sociology, content strategies, and arts and aesthetics by following human-center approaches.

> Human-centred design is an approach to interactive systems development that aims to make systems usable and useful by focusing on the users, their needs and requirements, and applying human factors/ergonomics and usability knowledge and techniques. This approach enhances effectiveness and efficiency, improves human well-being, user satisfaction, accessibility, sustainability, and counteracts possible adverse effects on human health, safety, and performance. [HCDSociety](https://human-centered-design.org/about/)
Expand Down
25 changes: 0 additions & 25 deletions chapter_owners.md

This file was deleted.

0 comments on commit 8596f0e

Please sign in to comment.