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

SP-1843: remove term 'delegate' #49

Merged
merged 8 commits into from
Jan 28, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/delegate-resources/assembly-recordings.rst
Original file line number Diff line number Diff line change
Expand Up @@ -15,14 +15,14 @@
.. A warning will alert you of identical labels during the linkcheck process.


################################
DP0 Delegate Assembly Recordings
################################
###############################
DP0 Science Assembly Recordings
###############################

.. This section should provide a brief, top-level description of the page.


.. list-table:: DP0 Delegate Assembly Recordings
.. list-table:: DP0 Science Assembly Recordings
:header-rows: 1
:widths: 1 2 2

Expand Down
24 changes: 11 additions & 13 deletions docs/delegate-resources/getting-started.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,27 +20,27 @@ Get started with DP0

.. This section should provide a brief, top-level description of the page.

**DP0 delegates** are the scientists and students who have accounts in the Rubin Science Platform (RSP)
**DP0 users** are the scientists and students who have accounts in the Rubin Science Platform (RSP)
at `data.lsst.cloud <https://data.lsst.cloud/>`__ and access to the Data Preview 0 (DP0) data sets.

Becoming a delegate and accessing the DP0 data is as easy as following the checklist below
Becoming a user and accessing the DP0 data is as easy as following the checklist below
and getting an account in the Rubin Science Platform (RSP).

There is no application process.
The only prerequisite is to be a Rubin data rights holder (see the `Rubin Data Policy <https://docushare.lsst.org/docushare/dsweb/Get/RDO-013>`_).
The number of delegates is currently limited to 900.
The number of users is currently limited to 900.
Space is available and all petitions are being accepted.
If that changes this page will be updated.


.. _DP0-Delegate-Resources-Get-Started-Checklist:

======================
New delegate checklist
======================
==================
New user checklist
==================

.. Important::
Rubin data rights are required in order to become a DP0 delegate and have an RSP account. Briefly, this includes students and scientists at US and Chilean institutions, and individuals whose name appears on the `list of international data rights holders <https://www.lsst.org/scientists/international-drh-list>`_; find details in the `Rubin Data Policy <https://docushare.lsst.org/docushare/dsweb/Get/RDO-013>`_. If you’re not sure if you have Rubin data rights, please contact Heather Shaughnessy ([email protected]) before proceeding with these steps.
Rubin data rights are required in order to become a DP0 user and have an RSP account. Briefly, this includes students and scientists at US and Chilean institutions, and individuals whose name appears on the `list of international data rights holders <https://www.lsst.org/scientists/international-drh-list>`_; find details in the `Rubin Data Policy <https://docushare.lsst.org/docushare/dsweb/Get/RDO-013>`_. If you’re not sure if you have Rubin data rights, please contact Heather Shaughnessy ([email protected]) before proceeding with these steps.


**Step 1.**
Expand All @@ -53,13 +53,11 @@ instructions on `how to get an RSP account <https://rsp.lsst.io/guides/getting-s
Everyone should use their full professional names and institutional email addresses.
The process to verify data rights and approve petitions can take a few days.
Please contact Melissa Graham at [email protected] or Heather Shaughnessy at [email protected] with any issues.
Once your petition is approved and you can log in to `data.lsst.cloud <https://data.lsst.cloud>`_, you are a DP0 delegate.
Once your petition is approved and you can log in to `data.lsst.cloud <https://data.lsst.cloud>`_, you are a DP0 user.

**Step 3.**
Get an account in the `Rubin Community Forum <https://community.lsst.org/>`__ and review how to get :doc:`/delegate-resources/support` for DP0.

It is recommended to go to `community.lsst.org/groups <https://community.lsst.org/groups>`_ and join the "DP0 Delegates" group.
DP0-related news and events are shared with this group.
Opt-in to receiving email notifications from the Forum by setting the profile preference for "Email me when I am sent a personal message" to "Always".
People new to the Rubin Community Forum might appreciate
`this video demonstrating how to navigate and post topics to the forum <https://www.youtube.com/watch?v=d_Z5xmkR4P4&list=PLPINAcUH0dXZSx2aY6wTIjLCWiexs3dZR&index=10>`_.
Expand All @@ -71,7 +69,7 @@ People new to the Rubin Community Forum might appreciate
Documentation and tutorials
===========================

All DP0 delegates are encouraged to use the documentation and tutorials to learn how to use the RSP to access and analyze LSST data,
All DP0 users are encouraged to use the documentation and tutorials to learn how to use the RSP to access and analyze LSST data,
and to generate and test custom software to prepare for when *real commissioning data* are released as Data Preview 1 (DP1) and DP2
(see the `plans for early science with Rubin Observatory <https://www.lsst.org/scientists/early-science>`__).

Expand Down Expand Up @@ -148,7 +146,7 @@ There are eight `LSST Science Collaborations <https://www.lsstcorporation.org/sc

**Participate in the Rubin Community Forum.**
Ask questions about DP0, or show-and-tell your DP0-related investigations in the `Data Preview 0 Community Forum category <https://community.lsst.org/c/support/dp0>`__.
Respond to questions or discussion topics raised by other DP0 delegates.
Respond to questions or discussion topics raised by other DP0 users.
This helps to build a global self-supporting network of scientists engaged in LSST research.

**Participate in virtual events.**
Expand All @@ -157,7 +155,7 @@ Ask questions and join the breakout discussions.
All are welcome to present their DP0-related experiences (contact Melissa Graham).

**Contribute tutorials.**
All delegates are welcome to share their own Jupyter Notebooks using the shared repositories
All users are welcome to share their own Jupyter Notebooks using the shared repositories
`delegate-contributions-dp02 <https://github.com/rubin-dp0/delegate-contributions-dp02>`__ or
`delegate-contributions-dp03 <https://github.com/rubin-dp0/delegate-contributions-dp03>`__.
Tutorials for the Portal, API, or command-line can also be contributed to these repos.
Expand Down
26 changes: 13 additions & 13 deletions docs/delegate-resources/guidelines.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Participation guidelines

.. This section should provide a brief, top-level description of the page.

All DP0 delegates must:
All DP0 users must:

* have Rubin data rights and abide by the :ref:`DP0-Delegate-Resources-Participation-Guidelines-Data-Rights`
* understand the :ref:`DP0-Delegate-Resources-Participation-Guidelines-Risks` of using the DP0-era RSP
Expand All @@ -35,7 +35,7 @@ Rubin data rights policy

Rubin data rights are required to hold an account in the Rubin Science Platform (RSP).

RSP accounts are not transferable and delegates must not share their password with others.
RSP accounts are not transferable and users must not share their password with others.

**Who has Rubin data rights?**
All scientists and students affiliated with an institution in the US and Chile have data rights,
Expand All @@ -56,7 +56,7 @@ Risks and caveats
=================

.. Important::
DP0 delegates are being given access to a *shared-risk developmental version* of the RSP and the accompanying documentation,
DP0 users are being given access to a *shared-risk developmental version* of the RSP and the accompanying documentation,
and should understand the `risks and caveats <https://dp0-2.lsst.io/data-access-analysis-tools/rsp-warnings.html>`__.


Expand All @@ -80,7 +80,7 @@ Please note that there are a few reasons why posts get flagged, and CoC violatio
Here are some guidelines on `how to react if your post is flagged <https://community.lsst.org/t/how-to-react-if-your-post-is-flagged>`_.

If you experience or witness a violation of the CoC in another venue, please reach out to Sandrine Thomas, one of the
`Rubin Observatory Workplace Culture Advocates <https://project.lsst.org/workplace-culture-advocate>`_ who has agreed to be the contact person for DP0 delegates.
`Rubin Observatory Workplace Culture Advocates <https://project.lsst.org/workplace-culture-advocate>`_ who has agreed to be the contact person for DP0 users.


.. _DP0-Delegate-Resources-Participation-Guidelines-PubPol:
Expand All @@ -94,20 +94,20 @@ If you publish work based on the DP0.1 or DP0.2 data set, you must cite “Cosmo
(`Korytov et al 2019 <https://ui.adsabs.harvard.edu/abs/2019ApJS..245...26K/abstract>`_), “The LSST DESC DC2 Simulated Sky Survey” (`arXiv:2010.05926 <https://arxiv.org/abs/2010.05926>`_),
and potentially “DESC DC2 Data Release Note” (`arXiv:2101.04855 <https://arxiv.org/abs/2101.04855>`_) if you used the Object or Truth-Match tables, which are presented in that release note.

**Consider extending co-authorship or acknowledgments to DP0 delegates whose work you used, or who have helped you, as appropriate.**
Delegates are encouraged to openly share their DP0-related work and/or code during :doc:`/delegate-resources/virtual-events`,
**Consider extending co-authorship or acknowledgments to DP0 users whose work you used, or who have helped you, as appropriate.**
Users are encouraged to openly share their DP0-related work and/or code during :doc:`/delegate-resources/virtual-events`,
via the `Community Forum <https://community.lsst.org/>`_, and in the shared GitHub shared repositories
`delegate-contributions-dp02 <https://github.com/rubin-dp0/delegate-contributions-dp02>`__ or
`delegate-contributions-dp03 <https://github.com/rubin-dp0/delegate-contributions-dp03>`__.
This is intended to facilitate collaboration, which requires proper acknowledgments.
For example, if you use another delegate’s Jupyter Notebook as a starting point for your Notebook, give credit to that person at the top of your Notebook.
If another delegate’s work contributed to your DP0-related publication, consider including an acknowledgment, citing their relevant publications, and/or extending co-authorship, as appropriate.
For example, if you use another user’s Jupyter Notebook as a starting point for your Notebook, give credit to that person at the top of your Notebook.
If another user’s work contributed to your DP0-related publication, consider including an acknowledgment, citing their relevant publications, and/or extending co-authorship, as appropriate.

**Be aware that DP0-related work done by Science Collaboration (SC) members might be subject to the publication policies of their Science Collaborations.**
Significant overlap between the DP0 working groups and SC working groups, committees, or task forces is to be expected, because the science goals of DP0 and the SCs overlap (i.e., preparing for LSST).
Each SC has their own policies regarding collaboration, co-authorship, and publications and delegates are responsible for following the policies of their SCs, if and when they pertain to their DP0-related work.
If cases of real or perceived conflict between the general open nature of DP0 collaboration and any SC policies arise, delegates are expected to understand and abide by their SC’s policies.
In other words, the fact that work is DP0-related does not nullify any SC policies that might apply to a delegate’s work.
Example scenarios might include sharing SC-developed software with delegates who are not members of that SC, or using code or analysis results collaboratively by delegates in a SC publication.
Each SC has their own policies regarding collaboration, co-authorship, and publications and users are responsible for following the policies of their SCs, if and when they pertain to their DP0-related work.
If cases of real or perceived conflict between the general open nature of DP0 collaboration and any SC policies arise, users are expected to understand and abide by their SC’s policies.
In other words, the fact that work is DP0-related does not nullify any SC policies that might apply to a user’s work.
Example scenarios might include sharing SC-developed software with users who are not members of that SC, or using code or analysis results collaboratively by users in a SC publication.

Note that the `Rubin Observatory Publication Policy <https://docushare.lsst.org/docushare/dsweb/Get/LPM-162>`_ does not apply to publications by delegates that are based on their DP0 work.
Note that the `Rubin Observatory Publication Policy <https://docushare.lsst.org/docushare/dsweb/Get/LPM-162>`_ does not apply to publications by users that are based on their DP0 work.
14 changes: 7 additions & 7 deletions docs/delegate-resources/index.rst
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
######################
DP0 delegate resources
######################
##################
DP0 user resources
##################

.. Review the README on instructions to contribute.
.. Review the style guide to keep a consistent approach to the documentation.
Expand All @@ -20,9 +20,9 @@ DP0 delegate resources

.. This section should provide a brief, top-level description of the page.

**DP0 delegates** are the scientists and students who have RSP accounts and access to the DP0 data sets.
**DP0 users** are the scientists and students who have RSP accounts and access to the DP0 data sets.

This page contains the guidelines and activities for DP0 delegates.
This page contains the guidelines and activities for DP0 users.


.. _DP0-Delegate-Resources-toc-get-started:
Expand All @@ -31,7 +31,7 @@ This page contains the guidelines and activities for DP0 delegates.
Get started with DP0
====================

Become a DP0 delegate by getting an account in the Rubin Science Platform.
Become a DP0 user by getting an account in the Rubin Science Platform.
Learn more about LSST and DP0 by participating in DP0-related activities.

.. toctree::
Expand Down Expand Up @@ -65,7 +65,7 @@ The Rubin Data Academy offers a one-week virtual program of hands-on learning.
Participation guidelines
========================

Review the policies that apply to all DP0 delegates.
Review the policies that apply to all DP0 users.

.. toctree::
:maxdepth: 2
Expand Down
4 changes: 2 additions & 2 deletions docs/delegate-resources/support.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,13 @@ Support

.. This section should provide a brief, top-level description of the page.

Several venues are provided to support DP0 delegates and RSP users, as described below.
Several venues are provided to support DP0 and RSP users, as described below.

If you're unsure which venue to use, `make a new topic <https://community.lsst.org/t/how-to-make-a-new-topic/8197>`__
in the Rubin Community Forum's `Support category <https://community.lsst.org/c/support>`__.

There is no wrong place to post questions or requests for assistance, so please don't hestitate.
Hearing about issues and receiving feedback from delegates is important to Rubin Observatory staff.
Hearing about issues and receiving feedback from users is important to Rubin Observatory staff.


.. _DP0-Delegate-Resources-Support-Forum:
Expand Down
4 changes: 2 additions & 2 deletions docs/delegate-resources/virtual-events.rst
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ The weekly Rubin Science Assemblies are live virtual sessions that focus on lear
Each assembly will start with announcements.
On alternating weeks there will either be a presentation (usually a hands-on tutorial),
or open drop-in time for Q&A with Rubin staff (like an office hour)
and breakout rooms for co-working with other delegates.
and breakout rooms for co-working with other users.

For presentation weeks, all are welcome to volunteer to speak or to suggest topics they would like to see covered
(contact Melissa Graham, [email protected]).
Expand Down Expand Up @@ -128,7 +128,7 @@ DP0 kick-off info sessions

When DP0.2 and DP0.3 were released, kick-off info sessions were held to provide
an overview of the available data products and how to access them via the RSP.
New delegates are recommended to watch the recorded presentations and review the
New users are recommended to watch the recorded presentations and review the
slide decks.

* `DP0.2 kick-off info session <https://community.lsst.org/t/dp0-2-kick-off-info-session-slides-pre-recorded-presentation/6846>`__
Expand Down
10 changes: 4 additions & 6 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,18 +10,16 @@ Data Preview 0 (DP0) is the first of three data previews during the period leadi
Rubin Science Platform (RSP) and to enable a limited number of scientists and students to begin early preparations for science with
**simulated** LSST-like data sets.

**DP0 delegates:** The scientists and students who have RSP accounts and access to the DP0 data sets.
This term reflects their important roles of representing the broad science community as learners, testers, and providers of feedback,
and of sharing the benefits of their DP0 participation with their communities as teachers and colleagues.
**DP0 users:** The scientists and students who have RSP accounts and access to the DP0 data sets.

.. toctree::
:hidden:

Delegate resources <delegate-resources/index>
User resources <delegate-resources/index>

.. grid:: 3

.. grid-item-card:: Delegate resources
.. grid-item-card:: User resources
:link: delegate-resources/index
:link-type: doc

Expand All @@ -45,4 +43,4 @@ Related documentation

- `Rubin Science Platform`_ — Learn how to use the Rubin Science Platform to access and analyze LSST data.
- `LSST Science Pipelines`_ — Learn about the Rubin LSST's Python data processing, measurement, and access software, which is pre-installed in the Rubin Science Platform.
- `github.com/rubin-dp0 <https://github.com/rubin-dp0>`_ - GitHub repository of tutorial notebooks (including delegate contributions) for both DP0.2 and DP0.3.
- `github.com/rubin-dp0 <https://github.com/rubin-dp0>`_ - GitHub repository of tutorial notebooks (including user contributions) for both DP0.2 and DP0.3.
Loading