docs: Update glab job artifact docs
Description
User feedback:
There is no definition for "refName". "main" is an easy example but what if I want the job of a mr pipeline?
This change improves the documentation and help text for a command that downloads build artifacts. The main updates include:
- Clearer wording: Changed "last pipeline" to "most recent pipeline" for better clarity
- Enhanced documentation: Added a detailed synopsis section explaining that it downloads artifacts from the most recent successful pipeline
-
Better parameter explanation: Added clear documentation explaining what
<refName>means - it can be a branch name, tag, or merge request reference, with specific formatting instructions for merge requests - Additional example: Added a new example showing how to download artifacts from a merge request pipeline using the special reference format
The changes make the command's purpose and usage much clearer for users, especially explaining the different ways to specify which pipeline to download artifacts from.