Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

More taylored instructions for iBridges #45

Merged
merged 15 commits into from
Sep 5, 2024
Merged

More taylored instructions for iBridges #45

merged 15 commits into from
Sep 5, 2024

Conversation

chStaiger
Copy link
Member

  • Links to documentation on Read the docs for CLI and API
  • Links to documentation on githubpages for GUI

It is complete, but maybe not so nice to read yet ...

Copy link
Member

@jelletreep jelletreep left a comment

Choose a reason for hiding this comment

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

Great manual! I do suggest to separate the GUI from the CLI instruction since it will create more focused and short manuals. I doubt whether have a combined introduction with then two subpages or two entire separate pages. What do you think @chStaiger ?

docs/manuals/ibridges.qmd Outdated Show resolved Hide resolved
docs/manuals/ibridges.qmd Outdated Show resolved Hide resolved
docs/manuals/ibridges.qmd Outdated Show resolved Hide resolved
docs/manuals/ibridges.qmd Outdated Show resolved Hide resolved
docs/manuals/ibridges.qmd Outdated Show resolved Hide resolved
docs/manuals/ibridges.qmd Outdated Show resolved Hide resolved
docs/manuals/ibridges.qmd Outdated Show resolved Hide resolved
docs/manuals/ibridges.qmd Outdated Show resolved Hide resolved
docs/manuals/ibridges.qmd Outdated Show resolved Hide resolved

iBridges is already installed on many SURF ResearchCloud workspaces developed by Utrecht University. You can check if it is present by simply typing the following command on your terminal: `ibridges`. If iBridges is installed, this should show you the program's help menu.

If you need to install iBridges, you can execute: `pip install ibridges`.
- If you need to install iBridges, you can execute: `pip install ibridges`.
- On desktop workspaces you can execute: `pip install ibridgesgui`.

### Creating an iRODS environment file
Copy link
Member

Choose a reason for hiding this comment

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

I suggest having separate pages for instructions for the gui and for python/CLI. Should we create two separate manuals? Or have one with the sections above here, and then have two links here to ibridges GUI and ibridges CLI/python?

Copy link
Member Author

Choose a reason for hiding this comment

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

I think one page is enough. But indeed we should create two distinct main sections on that page.


To start the GUI application you would then need to open a terminal and type in `ibridges-gui`.

Please contact us if you need to install iBridges or if you have any trouble with the installation.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Please contact us if you need to install iBridges or if you have any trouble with the installation.
Please contact us if you need help with installing iBridges or if you want to have iBridges preinstalled on your workspace.

@jelletreep jelletreep removed the request for review from dometto September 5, 2024 11:15
#### Connect to iRODS or Yoda not hosted by Utrecht University
#### What shall I do if iBridges is not on my workspace?

If you are confident with python and git you can install the packages:
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
If you are confident with python and git you can install the packages:
If your workspace has python installed, you can install the packages using the command line (or aka terminal):

@jelletreep jelletreep merged commit fa71831 into main Sep 5, 2024
1 check failed
@jelletreep jelletreep deleted the ibridges-doc branch September 5, 2024 13:43
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