Skip to content

Draft: Made changes to roadmap (added graphics, new info, and changed wording)#994

Draft
daniellawright wants to merge 1 commit into
CHTC:masterfrom
daniellawright:draft-roadmap
Draft

Draft: Made changes to roadmap (added graphics, new info, and changed wording)#994
daniellawright wants to merge 1 commit into
CHTC:masterfrom
daniellawright:draft-roadmap

Conversation

@daniellawright

Copy link
Copy Markdown
Contributor

No description provided.

@daniellawright daniellawright requested a review from xamberl July 2, 2026 22:47
@daniellawright daniellawright changed the title draft: made changes to roadmap (added graphics, new info, and changed wording) Draft: made changes to roadmap (added graphics, new info, and changed wording) Jul 3, 2026
@daniellawright daniellawright changed the title Draft: made changes to roadmap (added graphics, new info, and changed wording) Draft: Made changes to roadmap (added graphics, new info, and changed wording) Jul 3, 2026
@xamberl xamberl marked this pull request as draft July 3, 2026 15:01
- **HTCondor** is a job scheduling software that will run your jobs out on the execution points.
- The **Execution Points** are the set of resources your job runs on.

High Throughput Computing systems specialize in running tens to millions small, independent jobs. On the other hand, High Performance Computing systems specialize in running a few, very large jobs that use multiple computers working together on the same problem.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
High Throughput Computing systems specialize in running tens to millions of small, independent jobs. On the other hand, High Performance Computing systems specialize in running a few, very large jobs that use multiple computers working together on the same problem.

<td>X</td>
<td>✓</td>
<tr>
<td>Examples</td>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<td>Example tasks</td>

More detailed information regarding CHTC's HTC system can be found in the <a href="https://chtc.cs.wisc.edu/uw-research-computing/htc-overview">⚙️ HTC Overview Guide</a>.

#### Step Two
### Step Two: Set Up Your Account and Submit Your First Job

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should keep the logging in and submitting jobs steps separate. Originally, we wanted to merge them because the logging in section was quite short initially, but with your changes and the cool new graphic, I think it can stand in its own section.

After following this tutorial, we <b>highly recommend</b> users review the <a href="https://chtc.cs.wisc.edu/uw-research-computing/multiple-jobs">Easily Submit Multiple Jobs</a> guide to learn how you can configure HTCondor to automatically pass files or parameters to different jobs, return output to specific directories, and other easily automated organizational behaviors.
<br>
</details>
The tutorial below shows how to run many jobs from one submit file, use different input files or settings for each job, and save output files in specific directories.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The tutorial below shows how to run many jobs from one submit file, use different input files or settings for each job, and save output files in specific directories.
The following guide demonstrates different examples on how to run multiple jobs from one submit file, use different input files or settings for each job, and save output files in specific directories.

<details>
<summary>Install your Software</summary>
<br>
Our <a href="https://chtc.cs.wisc.edu/uw-research-computing/htc/guides.html">Software Solutions</a> guides contain information about how to install and use software on the HTC system.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Our <a href="https://chtc.cs.wisc.edu/uw-research-computing/htc/guides.html">Software Solutions</a> guides contain information about how to install and use software on the HTC system.
Our <a href="htc/guides#software">software</a> guides contain information about how to install and use software on the HTC system.

After your test jobs finish, we recommend you check for:

- Jobs that were placed on hold. You can view hold messages with <code>condor_q jobID -hold</code>.
- Expected output files.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Expected output files.
- Expected output files - are they in the right location, and do they show the expected output?


- Jobs that were placed on hold. You can view hold messages with <code>condor_q jobID -hold</code>.
- Expected output files.
- The size and number of output files. This helps you make sure files are being saved in the correct location and that your quota is large enough for your output data when you submit more jobs.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- The size and number of output files. This helps you make sure files are being saved in the correct location and that your quota is large enough for your output data when you submit more jobs.
- The size and number of output files. This helps you make sure that your quota is large enough for your output data when you submit more jobs.

- Expected output files.
- The size and number of output files. This helps you make sure files are being saved in the correct location and that your quota is large enough for your output data when you submit more jobs.

If your first test job works as expected, run a small batch next, such as 5 to 10 jobs. This gives you a chance to test your workflow at a slightly larger scale before submitting everything.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If your first test job works as expected, run a small batch next, such as 5 to 10 jobs. This gives you a chance to test your workflow at a slightly larger scale before submitting everything.
If your first test job works as expected, scale up your test by running a small batch next, such as 5 to 10 jobs. This gives you a chance to test your workflow at a slightly larger scale and ensure your pipeline works before submitting everything.


If your first test job works as expected, run a small batch next, such as 5 to 10 jobs. This gives you a chance to test your workflow at a slightly larger scale before submitting everything.

When the small batch finishes, review the output files and check your available storage space, also called your **quota**. This will help you estimate whether you have enough space for the files your full workflow will create.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When the small batch finishes, review the output files and check your available storage space, also called your **quota**. This will help you estimate whether you have enough space for the files your full workflow will create.
When the small batch finishes, review the output files and [check your available storage space](check-quota), also called your **quota**. This will help you estimate whether you have enough space for the files your full workflow will create.


When the small batch finishes, review the output files and check your available storage space, also called your **quota**. This will help you estimate whether you have enough space for the files your full workflow will create.

If the test jobs finish successfully and your quota is large enough, you are ready to submit your full workflow!

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If the test jobs finish successfully and your quota is large enough, you are ready to submit your full workflow!
> If the test jobs finish successfully and your quota is large enough, you are ready to submit your full workflow!

Putting this in a block quote for emphasis.

@xamberl

xamberl commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

@daniellawright All of this looks great! The RCF team loves how clear your graphics are, and the writing is pretty clear and organized. Most of the suggestions I made are very minor language changes, or things that RCFs wanted to emphasize that you may not have known.

Beside the suggested changes, we discussed breaking this up into separate pages or keeping as one long page. For now, we propose keeping it as one page with some modifications:

  • Add a Table of Contents section above everything (you can see one of our other guide pages for how that code block works), or the style guide I sent you a while back. Here's a TOC generator that may be useful: https://derlin.github.io/bitdowntoc/
  • Add a basic roadmap graphic to summarize the different steps we take them through. We'll place this at the very top.

I think it looks great, and we're very close to finalizing the new roadmap!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants