Skip to content

Clarify editable installation step in README#3

Open
xzckay wants to merge 1 commit into
jldz9:mainfrom
xzckay:improve-readme-installation-note
Open

Clarify editable installation step in README#3
xzckay wants to merge 1 commit into
jldz9:mainfrom
xzckay:improve-readme-installation-note

Conversation

@xzckay

@xzckay xzckay commented Jun 1, 2026

Copy link
Copy Markdown

This PR improves the installation documentation by clarifying the editable installation step.

Changes:

  • Added a note explaining that the command should be run from the repository root directory.
  • Clarified that the Conda environment should be activated first.
  • Explain why the trailing "." is required in the editable installation command.

The change is based on installation testing performed on Windows 11.

@jldz9 jldz9 left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

Replacing . to ./ in pip install -e .
will improve the readablity and this Note is potentially unnecessary

Comment thread README.md
cd InSARHub
conda env create -f environment.yml -n insarhub_dev
conda activate insarhub_dev
**Note:

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

Replacing . to ./ in pip install -e .
will improve the readablity and this Note is potentially unnecessary

Comment thread README.md
cd InSARHub
conda env create -f environment.yml -n insarhub_dev
conda activate insarhub_dev
**Note:

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

Suggested change
**Note:

Comment thread README.md
conda env create -f environment.yml -n insarhub_dev
conda activate insarhub_dev
**Note:
Run this command from the repository root directory after activating the Conda environment.

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

Suggested change
Run this command from the repository root directory after activating the Conda environment.

Comment thread README.md
conda activate insarhub_dev
**Note:
Run this command from the repository root directory after activating the Conda environment.
The trailing "." is required because pip installs the current project in editable mode.**

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

Suggested change
The trailing "." is required because pip installs the current project in editable mode.**

Comment thread README.md
**Note:
Run this command from the repository root directory after activating the Conda environment.
The trailing "." is required because pip installs the current project in editable mode.**
pip install -e .

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

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

Suggested change
pip install -e .
pip install -e ./

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