ECP/VTK-m project management

From VTKM
Revision as of 17:19, 8 January 2020 by Kmorel (talk | contribs) (Created page with "This page provides information for members of the ECP/VTK-m project (that is, the VTK-m funding that is directly coming from ECP). This information is mostly for the ECP/VTK-m...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This page provides information for members of the ECP/VTK-m project (that is, the VTK-m funding that is directly coming from ECP). This information is mostly for the ECP/VTK-m co-PIs, but may be of use to other members. The ECP/VTK-m project is managed through 3 separate project management systems. These are:

  • ECP/VTK-m Project Management GitLab Page This page manages the tasks that we are performing under the ECP/VTK-m funding. We are mainly using the issue tracker to track the activities for a given quarter. The issues here contain only short summaries and links to code issues and MR in the main VTK-m project source project.
  • VTK-m GitLab Repo The GitLab-hosted repository has its own page with a separate issue tracker. The issue tracker on the VTK-m repo is used to document technical designs as well as document bugs and other changes that need to be addressed. VTK-m repo is shared with all VTK-m developers, not just those funded by ECP/VTK-m.
  • ECP's JIRA Eventually, information from the project management GitLab page makes its way to the JIRA instance used by ECP to report on our progress. However, once you enter your progress in our GitLab project management, Ken will transfer the information over to JIRA as necessary. Hence, I'm not bothering to put the link here.

Because they are both hosted on the same GitLab instance and they both are part of the VTK-m management and development, it is easy to get the ECP/VTK-m Project Management Page and the VTK-m Repo confused with each other, but they serve different purposes.

Structure of the ECP/VTK-m Project Management Page

The ECP/VTK-m Project Management Page exists to fill in the gap between how we actually do our work and how ECP requires us to report our work. ECP essentially requires work to be broken into roughly 3 months increments with no overlap. In contrast, we are always working on many independent tasks, most of which take longer than 3 months.

The ECP/VTK-m Project Management Page manages this by crossing the reports to ECP with the tasks we are actually working on. Each task will have many issues: a separate issue for each ECP report.

The advantage of this approach is that it makes it easy for us to view what our current tasks are. If you go to the ECP/VTK-m Project Management Page, you will see in the description a set of links under the heading What am I Working On? Click on the one for your institution to see what your current tasks are.

As you perform work, you are encouraged to go to your active tasks on the ECP/VTK-m Project Management Page and add comments to issues to report the work that you have done. In particular, make links to merge requests and issues created in the VTK-m Repo in support of the task. Also report outreach activities.

Common Reporting

An Example

FAQ

When is my work due?

Should I edit my tasks on the ECP/VTK-m Project Management Page?

Yes, you are encouraged to add comments to your issues on the ECP/VTK-m Project Management Page. In addition to simple notes on progress, the following items eventually need to be reported on each task:

  • URL to issues in the VTK-m Repo that document design.
  • URL to merge requests in the VTK-m Repo that implement the task.
  • In the special Outreach task, any professional activities. This can include the following:
    • papers written/submitted/published
    • serving as chair
    • serving on a committee
    • participating in panels
    • giving tutorials
    • review activities
    • participating in workshops

Make sure you are reporting your work on the issue for the appropriate quarter.