Updating front page, adding contribution include, adding initial content lists to role pages.

Author: jcohen02

docs/_includes/can-you-help.html

@@ -0,0 +1,8 @@
+**Can you help contribute content to this page?:** The RSEToolkit is a
+community resource that is a work in progress. Can you help to add content
+to this page? We'd love to receive your contribution. See our
+[contributing guidelines]({{ site.baseurl }}{% link contributing.md %}) for
+details of how to provide content. You can also [open an issue](https://github.com/RSEToolkit/RSEToolkit.github.io/issues/new/choose)
+highlighting any content you'd like us to provide but aren't able to contribute
+yourself.
+{: .notice--info}

docs/_pages/index.md

@@ -12,14 +12,14 @@ header:
     - label: "New to RSE"
       url: /roles/new-rse/
     - label: "Experienced RSE"
-      url: "#"
+      url: "/roles/experienced-rse/"
     - label: "Researcher"
-      url: "#"
+      url: "/roles/researcher/"
 ---
 
-# RSE Toolkit: The Research Software Engineer's Toolkit
+# RSEToolkit: The Research Software Engineer's Toolkit
 
-The RSE Toolkit (RTK) is intended to be a community developed resource for Research Software Engineers (RSEs), researchers, academics and anyone involved in building research software. If you're a user of research software, or you're new to the field, you may also find a range of useful information on this site and its [associated GitHub repository]({{ site.github.repository_url }}).
+The RSEToolkit (RTK) is intended to be a community developed resource for Research Software Engineers (RSEs), researchers, academics and anyone involved in building research software. If you're a user of research software, or you're new to the field, you may also find a range of useful information on this site and its [associated GitHub repository]({{ site.github.repository_url }}).
 
 **Suggest or contribute new content:** The RSEToolkit is a work in progress. We're continuing to develop the resource and are always happy to receive contributions via [our GitHub repository](https://github.com/rsetoolkit/rsetoolkit). You can [open an issue](https://github.com/RSEToolkit/RSEToolkit.github.io/issues/new/choose) if there's some content you'd like us to add, or you can contribute content directly by following our [contributing guidelines]({{ site.baseurl }}{% link contributing.md %}).
 {: .notice--info}
@@ -30,11 +30,10 @@ The RSE Toolkit (RTK) is intended to be a community developed resource for Resea
  - ###### [Training Hub]({{ site.baseurl }}{% link _pages/training/training.md %})
  - ###### [Research Hub]({{ site.baseurl }}{% link _pages/research/research.md %})
  - ###### [Subject Guide]({{ site.baseurl }}{% link _pages/subjectguide/guide.md %})
- - ###### rtk
 
 ## Why RTK?
 
-This started out as an idea quite some time ago - indeed the (until recently empty) GitHub repository was created a while back with a view to developing this resource! The RSE community in the UK and beyond has been developing rapidly with groups and communities being started and growing at quite a pace as the interest in research software engineering continues to increase. This resource is intended to support this growth and provide a place where community members can link to their own materials or collaboratively develop new materials.
+The RSE community in the UK and beyond has been developing rapidly with groups and communities being started and growing at quite a pace as the interest in research software engineering continues to increase. This resource is intended to support this growth and provide a place where community members can link to their own materials or collaboratively develop new materials.
 
 There is a wealth of information out there but with so much information, it can sometimes be difficult to find what we're looking for, or more generally, to find a summary of the things it is useful to know or be aware of as an RSE.
 
@@ -52,9 +51,10 @@ The core set of resources that RTK is aiming to develop initially is:
 
  - **[Research Hub]({{ site.baseurl }}{% link _pages/research/research.md %}):** Information on RSE-related research resources, how to get research credit for your RSE work if you're a research-focused RSE and advice and links to resources to help develop your research profile as an RSE.
 
- - **rtk:** A Python command line tool with pluggable modules for undertaking common RSE tasks - develop and contribute your own modules or help to extend existing code.
-
-The RTK resources will be available through the GitHub pages site for RTK and can be accessed at [https://github.com/RSEToolkit/RSEToolkit.github.io](https://github.com/RSEToolkit/RSEToolkit.github.io).
+ - **[Subject Guides]({{ site.baseurl }}{% link _pages/subjectguide/guide.md %}):** Are you about
+ to start a new project in a field that you've not previously worked in? Want a quick overview
+ of the field? Want to know where to look for some helpful information? Check out our
+ [subject guides]({{ site.baseurl }}{% link _pages/subjectguide/guide.md %}).
 
 ## Code of Conduct
 

docs/_pages/research/research.md

@@ -7,4 +7,6 @@ layout: single
 
 # Research Resources
 
-Details of research resources for RSEs.
+Details of research resources for RSEs.
+
+{% include can-you-help.html %}

docs/_pages/roles/experienced-rse.md

@@ -7,6 +7,28 @@ layout: single
 
 ## Research Resources
 
-Details of research resources for RSEs.
+A guide for experienced RSEs:
 
-A guide for experienced RSEs.
+ - Following best practices for research software engineering
+    - Project structures
+    - Version control
+    - Licensing
+    - Testing
+    - Managing errors, issues, contributions, etc.
+    - CI/CD
+    - ...
+
+ - RSE team structures
+ - Managing projects
+ - Managing RSEs
+ - Language guides and resources
+     - Python
+     - R
+     - C/C++
+     - Java
+     - FORTRAN
+     - JavaScript
+     - Go
+     - Rust
+
+{% include can-you-help.html %}

docs/_pages/roles/new-rse.md

@@ -7,8 +7,12 @@ layout: single
 
 ## Research Resources
 
-Details of research resources for RSEs.
-
 A guide introducing RSE to newcomers to the field
 
-What is an RSE?
+ - What is an RSE?
+ - Where are RSEs based? (central teams, embedded in research groups, etc.)
+ - Where to look for RSE jobs
+ - Pointers to information on core skills, best practices, etc.
+ - ...
+
+ {% include can-you-help.html %}

docs/_pages/roles/researcher.md

@@ -7,6 +7,16 @@ layout: single
 
 # Research Resources
 
-Details of research resources for RSEs.
+A guide for researchers and academics building or working with research
+software.
 
-A guide for researchers and academics building or working with research software.
+ - Researcher or RSE?<br/><small>How does the work that RSEs do differ
+ from researchers who write code?</small>
+ - Publishing software outputs
+ - Licensing research software
+ - Ensuring reproducibilty of computational research
+ - Sharing and archiving code
+ - Developing a community around your software outputs
+ - ...
+
+ {% include can-you-help.html %}

docs/_pages/softdev/softdev.md

@@ -7,4 +7,6 @@ layout: single
 
 ### Software Development Resources
 
-Details of research resources for RSEs.
+Details of software development resources for RSEs.
+
+{% include can-you-help.html %}

docs/_pages/subjectguide/guide.md

@@ -11,3 +11,4 @@ Guides for RSEs new to working in a range of different domains
 
 We have prepared some example guides for the following subjects.
 
+{% include can-you-help.html %}

docs/_pages/tech/tech.md

@@ -7,4 +7,6 @@ layout: single
 
 # Technical Resources
 
-Details of technical resources for RSEs.
+Details of technical resources for RSEs.
+
+{% include can-you-help.html %}

docs/_pages/training/training.md

@@ -7,4 +7,6 @@ layout: single
 
 # Training Resources
 
-Details of training resources for RSEs.
+Details of training resources for RSEs.
+
+{% include can-you-help.html %}