The title of this page was called ‘GitHub Basics’. That is useless for SEO. What would people actually search for if they wanted to find this page? I suggest ‘Using GitHub with Dyalog’.
Using GitHub with Dyalog
Dyalog Ltd develops some tools using Git and hosts the source code and distributable packages using GitHub.
If you are unfamiliar with GitHub, some basic actions are explained below to help you get started.
Import Directly to the Workspace
If a tool is purely APL code (for example, a workspace or APL text source files) then it might be possible to bring it directly into the workspace using the experimental ]Get user command.
For example, to get the latest release of HttpCommand:
- Navigate to the HttpCommand releases page in GitHub.
- Under Assets, right-click on HttpCommand.dyalog.
- Select Copy Link from the drop-down menu.
- In a Dyalog Session, enter
]Getand paste the link in the same line. Press Enter.
]Get https://github.com/Dyalog/HttpCommand/releases/download/v5.9.3/HttpCommand.dyalog
#.HttpCommand
(HttpCommand.GetJSON 'GET' 'https://catfact.ninja/fact').Data.fact
Your cat's heart beats at a rate almost double that of yours, from 110-140 beats per minute.
See ]Get -? for more information and examples.
Using the Latest Development Version
- Open the project of interest.
- Click on Code.
- Select Download ZIP from the drop-down menu.
Reporting Issues
If you have trouble using a tool, or want to suggest an improvement, open an issue on GitHub.
- Open the project’s page on GitHub
- Click on the Issues tab
- Click on the New issue button
Remember to include steps to reproduce your issue, the version number of the tool you are using and information about your operating environment.
Developing a Tool
This is a very brief summary of the Fork and Pull Request collaborative development procedure. For more thorough introductions to Git and GitHub, see:
Changes over time can be viewed on the GitHub page for the project. For example, the changes for library-conga can be viewed at github.com/Dyalog/library-conga/commits/master.
To participate in the development of a tool, or to fix an issue that you’ve spotted:
- Ensure that you have a GitHub account and are logged in.
- Open the project of interest.
- Click on Fork (in the top right corner of the project window)
This takes a copy of the project to your account for you to work on. We recommend that you use a tool such as Atlassian SourceTree (unless you are already a seasoned Git user, in which case you already know what to do) and “clone” the repository from there. - Once you have made changes to your fork of the project, click on Pull requests (near the top left corner of the project window) – this informs us that your changes are ready for us to review and include in the project.
If you have any issues whilst trying to make updates, please contact us – we’re happy to talk you through the necessary process.
Note for Fi/content creators: avoid using raw URLs as link text. Use clear, descriptive anchor text to improve accessibility and SEO.
