galasa-dev / galasa.dev Goto Github PK

@CaroMac FYI there are two new methods on the CICS TS manager. I can provide some documentation please could you advise how to incorporate this into documentation or what to do :)

Documentation requested by Tony Clay in galasa users channel

'Introduction and Architecture' is the only sidebar item not to use sentence-style capitalisation.

New Manager template structure is here -
https://deploy-preview-365--galasa.netlify.app/docs/managers/manager-name

Example of new template used for GitHub Manager is here -

https://deploy-preview-404--galasa.netlify.app/docs/managers/github-manager#configuring

New Manager template structure is here -
https://deploy-preview-365--galasa.netlify.app/docs/managers/manager-name

Example of new template used for GitHub Manager is here -

https://deploy-preview-404--galasa.netlify.app/docs/managers/github-manager#configuring

Overview

• https://deploy-preview-402--galasa.netlify.app/docs/ecosystem/automating/overview .

[I would like to get feedback on this please and on the diagrams used. If the diagrams are the best ones to use then I will get them drawn in figma. They are just screenshots at the moment.]

Visit https://galasa.dev/ and maximise your browser.

A horizontal scrollbar (incorrectly) appears - confirmed in Chrome and Firefox.

Edit: Forgot to say that if you gradually reduce the width of the browser window, below a particular width, the scrollbar disappears.

Similar to Maven but using Gradle

Let's use descriptive link text rather than 'here' or 'download' or similar, to aid readability, screen readers, and SEO.

Links I've spotted on pages:

• /docs/getting-started/installing
• /docs/running-simbank-tests/simbank-IVT

Under Getting Started, in the subtopic 'Launching SimBank' (which might perhaps be named 'Launching Galasa SimBank'), the instructions say "If you have previously started SimBank, then select and run its run configuration". I wonder if it will be clear to all users how to 'select and run its run configuration'. Could the docs perhaps explain more about using the Run Configurations menu and selecting the Run Configuration that you created for SimBank?

New Manager template structure is here -
https://deploy-preview-365--galasa.netlify.app/docs/managers/manager-name

Example of new template used for GitHub Manager is here -

https://deploy-preview-404--galasa.netlify.app/docs/managers/github-manager#configuring

This dummy GitHub issue describes a problem in source code that results in a HttpServerErrorException message being returned when a test is run.

Starter Epic for Aaron.

This is a peice of work to help get the Simbank samples and repositories back up to date with the current versions of Galasa and in working order with up to date documentation.

Dummy issue created for documentation of the GitHub Manager.

GitHub issue 1178 has a status of open on GitHub in the galasa-dev/projectmanagement repository. Issue 1178 tracks a known problem with the behaviour of the Z/OS Batch Manager. The issue causes the test class BatchAccountsOpenTest to fail.

Feedback from SHARE via James.

When reading the doc section on manually exploring SimBank, some users came to the incorrect conclusion that they needed to tie PCOMM up with Galasa in some way. This is not true - PCOMM is used independently to let people play with SImBank but is not needed for Galasa.

Add a note to make this clear.

Revist Manager content:
Layout
ToC

Gather and collate user feedback:
Development team - initial feedback received
CiP - meeting created for 9 Feb
Other

Re-design content inc Ben, Will B
Playback feedback findings and work out plan, applying design thinking

Present redesign

New Manager template structure is here -
https://deploy-preview-365--galasa.netlify.app/docs/managers/manager-name

Example of new template used for GitHub Manager is here -

https://deploy-preview-404--galasa.netlify.app/docs/managers/github-manager#configuring

Deploying tests to maven -
https://deploy-preview-402--galasa.netlify.app/docs/ecosystem/deploying-tests.

On the page /docs the following instruction occurs:

This hub page contains links to the main Galasa documentation. To get going with Galasa as quickly as possible, explore the Getting started section on the left-hand menu.

This won't be true when using a small form factor.

User testing with new users indicates that the key features on the front page ('Lighten the load', etc) draw in users but then they can take no action based on them.

The text itself interests them, and they wish to click through to to see how they can do X Y and Z, but there's nothing - it becomes a dead end and they have to start the trawl for information from scratch once they get into the About or Docs sections.

New Manager template structure is here -
https://deploy-preview-365--galasa.netlify.app/docs/managers/manager-name

Example of new template used for GitHub Manager is here -

https://deploy-preview-404--galasa.netlify.app/docs/managers/github-manager#configuring

For information on contributing the new managers see https://github.com/galasa-dev/galasa.dev readme.

Links to the new template structure and a worked example are included in the issues themselves.