Rearrange the RSE section for readability

Author: rkdarst

about/for-proposals.rst

@@ -150,7 +150,7 @@ Research software engineering services
 
 .. seealso::
 
-   :doc:`/rse/grant-applicants`
+   :doc:`/rse/for-grant-applicants`
 
 (this text must be tuned to your grant, replace the parts in CAPITAL LETTERS)
 

about/join.rst

@@ -116,7 +116,7 @@ their members can receive short-term support without any billing
 needed.  Their members will also receive priority for the project
 services.
 
-For more information, see the :doc:`RSE for units </rse/units>` page.
+For more information, see the :doc:`RSE for units </rse/for-units>` page.
 
 
 Contact

rse/contact.rst

@@ -0,0 +1,41 @@
+Requesting RSE support
+======================
+
+You can contact us regardless of how small your issue is - or even if
+you would like to know if we could help your project.  At least, we
+can point you in the right direction.
+
+
+
+Office hour ("garage")
+----------------------
+
+We recommend you come to our daily :ref:`garage sessions
+<scicomp-garage>` for a short chat.  There are no reservations, and
+this is the online equivalent of dropping by our office to say hi.
+Since it is online, there are a wide variety of staff ready to answer
+almost any computing or software problem you may have.
+
+
+
+Contact
+-------
+
+We recommend you come to our daily :ref:`garage sessions
+<scicomp-garage>` (see above), rather than send email (or to come by
+after you send the email).  We almost always have more questions and
+want to chat as a first point anyway.  Email can work to arrange a
+meeting some other time, though.
+
+Our email is rse@aalto.fi
+
+
+
+Request form
+------------
+
+You can also use the `structured request form
+<https://selfservice.esupport.aalto.fi/ssc/app#/order/2026/>`__
+("Research Software Engineer request").  This guides you through some
+of our initial questions so we can evaluate quickly.  Still, we will
+quickly invite you to garage for a chat.

rse/grant-applicants.rst rse/for-grant-applicants.rstrse/grant-applicants.rst renamed to rse/for-grant-applicants.rst

@@ -0,0 +1,56 @@
+RSE info for group leaders
+==========================
+
+Aalto Research Software Engineers are part of Science-IT, a research
+infrastructure in the School of Science.  We serve everyone in Aalto,
+though.
+
+If your group needs computing, data, or research software development,
+but it's something that you don't have time to do or it isn't your
+specialty, we can help with that while you focus on your actual
+science.  We are all former researchers ourselves and can seamlessly
+work with you.
+
+
+
+Small support: "Garage" office hour
+-----------------------------------
+
+If you or your group has any short term problems and want to talk to a
+specialist in computing, send them to the :doc:`Scientific Computing
+Garage </help/garage>` any workday at 13:00.  In it, you can ask
+anything and usually get an answer, or at least a pointer to the
+answer.  You can, of course, also make use of this yourself to contact
+us to discuss your plans.
+
+The garage is the starting point for small projects which go beyond
+garage but still are mostly in your hands.
+
+**Tell your group member's it's OK to ask for help.**
+
+
+
+Larger projects
+---------------
+
+We also do larger projects, for example developing a significant piece
+of software or service for your project.  See :doc:`portfolio` for
+examples.  For these, we often act as part of your research team for
+the duration.
+
+Depending on your unit, you get various amounts of time for free: the
+idea is that it's better to help with medium size things than get
+stuck up in finance practices.  For supporting units (currently
+mostly SCI), we can do amount a month of work "for free".  Beyond
+that, we'll discuss and use some other funding.
+
+If you have an idea, either current or future, we recommend discussing
+with us as soon as possible.
+
+
+Preparing ideas
+---------------
+
+If you have a future idea or are writing a grant, we can help with
+planning your ambitions to see what is even possible.  Writing in our
+services can make your grant more competitive, see :doc:`/about/for-proposals`.

rse/for-group-leaders.rst

@@ -11,86 +11,68 @@ software, computing, and data. As research becomes more digital and
 computer-dependent, the prerequisite knowledge grows larger and
 larger, and we exist to help you fill that gap.
 
-For anything related to **custom software development, computational
-research, data management, workflow automation, scaling-up, deployment
-of public previews,
-collaborative work, reproducible research, optimization,
-high-performance computing, and more**, we can be the collaborator you
-need.  We can:
-
-* **Do it for you:** You need some custom technical
-  software/solution.  We do it for you, you get straight to your work.
-* **Do it with you:** We co-work with your group, teaching while we go
-  along.
-* **Make it reusable:** You already have something, but it doesn't
-  work for others.
-* **Plan your ambitions:** Figure out how far you can reach in your
-  next project or grant.
-
-Instead of, or in addition to, hiring your own intern, postdoc,
-etc. to struggle with
-certain issues, we can help you. Our working groups consist of experienced
-researchers who have broad experience with scientific computing
-in academic projects. We can also do
-consultation and training. You will have more
-impact since your work will become more reusable, open, and of a higher quality. We
-can work on your ongoing projects, or you can add us directly into your next
-grant application.
-
 .. _rse-history: https://www.software.ac.uk/blog/2016-08-17-not-so-brief-history-research-software-engineers-0
 
-**Service availability:** Our daily help session :ref:`SciComp Garage
-<scicomp-garage>` is available to researchers at Aalto.  Medium-length
-projects (days--weeks) is available for "free" in proportion to our
-funding from various :doc:`units in proportion to their funding
-<procedures/units-info>`.  Longer projects (month+) should have their
-:doc:`own project funding <procedures/finance-practicalities>`.
-
-.. admonition:: Contact
-
-   It's best to talk live!  Come to our :ref:`online office hour ("SciComp
-   Garage") <scicomp-garage>` any workday at 13:00. You don't even
-   need a specific question; you can ask about a vague idea, if
-   we are even the right place to ask, or drop by to chat about your
-   experiences.  This is also how you would start a larger project
-   with us.
+We support people, not software or infrastructures.  For anything
+related to **custom software development, computational research, data
+management, workflow automation, scaling-up, deployment of public
+previews, collaborative work, reproducible research, optimization,
+high-performance computing, and more**, we can be the collaborator you
+need.  We can either give quick support or do longer term projects, either as
+a collaborator or leader.
 
-   See :ref:`requesting RSE <request-rse>` for more including email.
 
+**Service availability:** Our daily help session :ref:`SciComp Garage
+<scicomp-garage>` is available to researchers at Aalto for free.  There is
+various funding for medium-length (days--weeks) projects from `various
+units <procedures/units-info>` at no cost to you.**  Longer projects (months+)
+are generally expected to have their own funding.
 
 
-About our services
-------------------
+Brief intros
+------------
 
 .. toctree::
    :maxdepth: 1
 
-   researchers
-   units
+   contact
+   for-researchers
+   for-group-leaders
+   for-grant-applicants
+   for-units
    portfolio
 
-
-
 .. _request-rse:
 
-How to get started
+Project procedures
 ------------------
 
-Contact us as mentioned above, or read here for more details.
-
 .. toctree::
    :maxdepth: 1
 
-   request
-   how-we-work
-   group-leaders
-   grant-applicants
+   project-lifecycle
+   project-setup
    procedures/finance-practicalities
 
 
+Old stuff below here
+--------------------
 
-About research software engineers
----------------------------------
+.. admonition:: Contact
+
+   It's best to talk live!  Come to our :ref:`online office hour ("SciComp
+   Garage") <scicomp-garage>` any workday at 13:00. You don't even
+   need a specific question; you can ask about a vague idea, if
+   we are even the right place to ask, or drop by to chat about your
+   experiences.  This is also how you would start a larger project
+   with us.
+
+   See :ref:`requesting RSE <request-rse>` for more including email.
+
+
+
+About the research software engineers
+-------------------------------------
 
 .. toctree::
    :maxdepth: 1
@@ -99,6 +81,9 @@ About research software engineers
    Become a RSE <become-a-rse>
    Video: Aalto RSE status report, May 2021 <https://www.youtube.com/watch?v=rvuwLSKLaJI>
    Video: Support services vs diversity <https://www.youtube.com/watch?v=z1VS1wleN-o>
+   reports/2022
+   reports/2023
+   reports/2024
 
 
 
@@ -120,17 +105,18 @@ Other pages on this site: :doc:`/scicomp/packaging-software`, :doc:`/scicomp/zen
 
 
 
-Internal documents
-------------------
+Team internal documents
+-----------------------
 
-We believe in openness, so make our procedures open.  They are subject
-to improvement at any time.  Also see the :doc:`FCCI Tech
-</tech/index>` seminar series for how our broader team works internally.
+We believe in openness, so make our procedures open.  They may be out
+of date and are subject to change at any time.  Also see the
+:doc:`FCCI Tech </tech/index>` seminar series for how our broader team
+works internally.
 
 .. toctree::
    :maxdepth: 1
 
-   procedures/project-administration
+   procedures/project-tracking
    procedures/templates
    procedures/prioritization
    procedures/units-info
@@ -139,35 +125,29 @@ to improvement at any time.  Also see the :doc:`FCCI Tech
    procedures/template-projects
    procedures/implementation
    history
-   reports/2022
-   reports/2023
-   reports/2024
 
 
 
-See also
---------
+Other similar services
+----------------------
+
+* The University of Helsinki also has a `Research Software Engineering
+  group
+  <https://wiki.helsinki.fi/xwiki/bin/view/Research%20Software%20Engineering%20group/>`__.
 
 * The CSC `optimization service
   <https://research.csc.fi/optimization-service>`__ is essentially a
   RSE service, targeted to CSC/LUMI resources (but in theory can do
-  more).  They are good at low-level programming kind of things.
+  more).  They are good at low-level programming kind of things.  With
+  funding, they can also collaborate on other projects.
 
 * The `Nvidia AI Tech Center <https://fcai.fi/nvaitc>`__ provides
   *free* RSE services for research projects for Finnish Center for AI
   members (includes Aalto).
 
-Related programs from Aalto Scientific Computing
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-This is the hands-on compliment our training programs, mainly
-:doc:`scientific computing in practice sessions </training/scip/index>` and
-`CodeRefinery <https://coderefinery.org>`_.  If you want a kickstart
-to put those lessons in practice, this is for you.  Attendance
-in these courses is useful but by no means required.
 
 Other links
-~~~~~~~~~~~
+-----------
 
 * :doc:`Aalto Scientific Computing </index>`, the organization behind
   this program.

rse/researchers.rst rse/for-researchers.rstrse/researchers.rst renamed to rse/for-researchers.rst

@@ -4,7 +4,7 @@ RSE financial practicalities
 Let's say you :doc:`know what we do <../index>` and have funding and
 would like to send it our way.  This page says what to do.  You can
 read :doc:`what we know about different funders
-<../grant-applicants>`, but it's probably better to ask your
+<../for-grant-applicants>`, but it's probably better to ask your
 controller directly if you have the funding already.