More basic info...

docs/source/coc.rst → docs/source/community/coc.rst

@@ -1,4 +1,4 @@
-.. _coc:
+.. _community-coc:
 
 Code of Conduct
 ===============

docs/source/community/contact.rst

@@ -3,23 +3,39 @@
 Contact
 =======
 
+Snowmass 2021
+-------------
+
+These are the central resources of the Snowmass 2021 process.
+
+* homepage: https://snowmass21.org
+* Indico page: https://indico.fnal.gov/category/1098/
+
+All communication types are `explained here <https://snowmass21.org/communicationtypes>`_.
+
+
 Mailing Lists
 -------------
 
 Our interest group and community organizes in the following ways:
 
-- Snowmass e-mail list
-- computational frontier e-mail list
-- COMPF2 e-mail list
-- interest group mailing list?
+- Snowmass e-mail server: ``listserv@fnal.gov`` (`help <https://listserv.fnal.gov/users.asp#subscribe%20to%20list>`_)
+- Snowmass e-mail list: ...
+- computational frontier e-mail list: ...
+- CompF2 e-mail list:  ``snowmass-compf02-theorycalcsim@fnal.gov`` (``SNOWMASS-COMPF02-THEORYCALCSIM``)
+- interest group mailing list? ...
+
+Please follow the instructions `outlined here <https://snowmass21.org/#join_slack_workspace_and_snowmass_email_list>`_ to join these mailing lists.
 
 
 Slack Channels
 --------------
 
-Our interest group and community organizes in the following ways:
+Snowmass 2021 also communicates actively via Slack, which is an online chat service.
+
+* Slack Server: https://snowmass2021.slack.com
+* general planning channel: ``#snowmass-2021-planning`` ``#general``
+* computational frontier (CompF) channel: ``#comp_frontier_topics``
+* Theoretical Calculations and Simulation (CompF2) channel: ``#compf02-theorycalcsim``
 
-- Snowmass e-mail list
-- computational frontier e-mail list
-- COMPF2 e-mail list
-- interest group mailing list?
+Please follow the instructions `outlined here <https://snowmass21.org/#join_slack_workspace_and_snowmass_email_list>`_ to join the Slack server.

docs/source/community/meetings.rst

@@ -7,7 +7,7 @@ Calendars
 ---------
 
 COMP
-^^^
+^^^^
 
 ...
 

docs/source/conf.py

@@ -62,17 +62,17 @@
 
 # General information about the project.
 project = u'SM2021-COMPF2-AccBeam'
-copyright = u'Homepage under CC-BY 4.0, Snowmass 2021 COMPF2 Accelerator & Beam Physics Modeling interest group'
+copyright = u'Under CC-BY 4.0, Snowmass 2021 COMPF2 Accelerator & Beam Physics Modeling interest group'
 author = u'Snowmass 2021 COMPF2 Accelerator & Beam Physics Modeling interest group'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = u'0.12.0'
+#version = u'2020.07'
 # The full version, including alpha/beta/rc tags.
-release = u'0.12.0-dev'
+#release = u'2020.07'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -149,8 +149,8 @@
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
     (master_doc, 'SM2021_COMPF2_AccBeam.tex',
-     u'Homepage of the Accelerator \& Beam Physics Modeling interest group (Snowmass 2021)',
-     u'Snowmass 2021 COMPF2 Accelerator \& Beam Physics Modeling interest group', 'manual'),
+     u'Accelerator \& Beam Physics Modeling in the Computational Frontier (CompF2: Theoretical Calculations and Simulation) in Snowmass 2021',
+     u'Accelerator \& Beam Physics Modeling interest group', 'manual'),
 ]
 
 

docs/source/index.rst

@@ -3,11 +3,11 @@
 Accelerator & Beam Physics Modeling
 -----------------------------------
 
-This is the homepage of the *Accelerator & beam physics modeling* interest group in the topical group *Theoretical Calculations and Simulation* (CompF2) of the APS DPF *Snowmass21* process.
+This is the homepage of the *Accelerator & beam physics modeling* interest group in the topical group `Theoretical Calculations and Simulation (CompF2) <https://snowmass21.org/computational/simulations>`_ which is part of the `Computational Frontier (CompF) <https://snowmass21.org/computational/start>`_ in the `Snowmass 2021 <https://snowmass21.org>`_ process organized by the Division of Particles and Fields (DPF) of the American Physical Society.
 
-...
+.. only:: html
 
-TODO: Download this whole homepage also as a PDF document here.
+   `Download this whole homepage also as a PDF document here <_static/SM2021_COMPF2_AccBeam.pdf>`_.
 
 .. raw:: html
 
@@ -16,17 +16,12 @@ TODO: Download this whole homepage also as a PDF document here.
     * needed for consistent HTML-PDF-EPUB chapters
     */
    div#introduction.section,
-   div#loi.section,
+   div#letters-of-interest.section,
    div#community.section {
        display:none;
    }
    </style>
 
-.. toctree::
-   :hidden:
-
-   coc
-
 Introduction
 ------------
 .. toctree::
@@ -36,10 +31,10 @@ Introduction
 
    introduction/topics
 
-LOI
----
+Letters of Interest
+-------------------
 .. toctree::
-   :caption: LOI
+   :caption: LETTERS OF INTEREST
    :maxdepth: 1
    :hidden:
 
@@ -56,4 +51,5 @@ Community
 
    community/contact
    community/meetings
+   community/coc
 

docs/source/introduction/topics.rst

@@ -3,20 +3,21 @@
 Topics
 ======
 
-As interest group of the *Theoretical Calculations and Simulation* (CompF2) topical group in the *Computational Frontier* our topics of interest include:
+As interest group in the `Theoretical Calculations and Simulation (CompF2) <https://snowmass21.org/computational/simulations>`_ topical group in the `Computational Frontier <https://snowmass21.org/computational/start>`_ our topics of interest include:
 
-* Modeling of 
+* **Modeling of**
 
   * Colliders (leptons, hadrons, gamma, mix)
+
     * rings
     * Linacs
     * Entire machine complex
-
   * Advanced Concepts
+
     * plasma accelerators (LWFA, PWFA)
     * dielectric
-
   * Specific physics topics
+
     * beam-beam
     * Halo
     * Collisions
@@ -28,15 +29,14 @@ As interest group of the *Theoretical Calculations and Simulation* (CompF2) topi
     * Quantum limit in novel accelerator structures
     * X-ray simulation
     * ...
-
   * Components
+
     * RF cavities
     * Magnets
     * ...
-
   * ...
+* **Crosscutting topics**
 
-* Crosscutting topics
   * Commonalities in comp. needs
   * EVA (End-to-end Virtual Accelerator)
   * HPC / Exascale / programming
@@ -46,7 +46,6 @@ As interest group of the *Theoretical Calculations and Simulation* (CompF2) topi
     * computing hardware independent implementation e.g. Kokkos/RAJA/Alpaka/AMReX
     * Mixed precision: half (various), single and double
     * Tensor cores
-
   * Standardization of output data, input scripts (openPMD, ...)
   * Data management & data reduction
   * Online modeling

docs/source/loi/contribute.rst

@@ -3,13 +3,29 @@
 Contribute
 ==========
 
-Letters of Intent (LOI) can be contributed in the following ways:
+`Snowmass 2021 Letters of Interest (LOI) <https://snowmass21.org/loi>`_ are informal documents intended to be useful in the first stages of the Snowmass study.
+They will help Snowmass conveners to prepare the Snowmass Community Planning Meeting that will take place early November 2020 virtually.
+LoIs could include opinions, interests and proposals that could further be studied.
+They should contain a maximum of 2 pages of text, plus relevant bibliography.
+Please make these as simple and easy to read as possible.
+Authors of the letters are welcome to make a full writeup for their work as a contributed paper and submit it to the Snowmass proceedings.
+However, a contributed paper is not required.
+
+**LoIs should be contributed until ...** (Snowmass upload close-out: **August 31, 2020**).
+
+For our interest group, we propose to use a simple template to simplify the process.
+They can be contributed in the following ways:
+
+* TODO: pull request example (rst)
+* TODO: pull request example (pdf)
+* TODO: per e-mail (tzzzz)
 
-* pull request example (rst)
-* pull request example (pdf)
-* per e-mail (tzzzz)
 
 Templates
 ^^^^^^^^^
 
 We suggest to use the following template for LOIs...
+
+.. note::
+
+   Do we collect contributions or do we advise authors to upload for themselves at https://snowmass21.org/loi ?