Skip to content

UX improvements: docs and saftey#19

Merged
phycodurus merged 2 commits intomainfrom
18-make-tom-docs-should-include-branch-options
Mar 24, 2026
Merged

UX improvements: docs and saftey#19
phycodurus merged 2 commits intomainfrom
18-make-tom-docs-should-include-branch-options

Conversation

@phycodurus
Copy link
Member

@phycodurus phycodurus commented Mar 20, 2026

UX improvements: docs and saftey

Specifically, document how to install a local branch of tom_base; and, don't allow the user to source the script (because it contains exit commands that will close their shell).

If the tone of the README is too casual, just let me know.

Issues:

Specifically, document how to install a local branch
of tom_base; and, don't allow the user to source the
script (because it contains exit commands that will
close their shell).
@phycodurus phycodurus linked an issue Mar 20, 2026 that may be closed by this pull request
Copy link
Contributor

@jchate6 jchate6 left a comment

Choose a reason for hiding this comment

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

slight wording change.

README.md Outdated

This is something you would do to work on a TOMToolkit issue, or develop a new feature that you might submit to us as a pull request (PR). Fantastic! Here's how:

After you've run the `make-tom.sh` script, in your TOM directory: run `pip install -e /path/to/your/local/branch/of/tom_base`
Copy link
Contributor

Choose a reason for hiding this comment

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

I think I would change this to:
"After you've run the make-tom.sh script, enter your new TOM's directory and run ..."

I don't want anybody to hastily miss a comma and run make_tom in their existing TOM directory.

@phycodurus phycodurus requested a review from jchate6 March 23, 2026 19:32
Copy link
Contributor

@jchate6 jchate6 left a comment

Choose a reason for hiding this comment

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

Nice

@jchate6 jchate6 moved this to Needs Review in TOM Toolkit Mar 23, 2026
@phycodurus phycodurus merged commit 7696872 into main Mar 24, 2026
@github-project-automation github-project-automation bot moved this from Needs Review to Merged (to dev) in TOM Toolkit Mar 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Merged (to dev)

Development

Successfully merging this pull request may close these issues.

make-tom docs should include branch options

2 participants