uabrc / uabrc/uabrc.github.io

Contrib guide git workflow cycle improvement

Open
#513 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

dev: enhancement 🛠️✨ style: article/section 📝
Dominant language
Python
Stars
24
Forks
15
Avg merge
10d 3h
Merged PRs (30d)
1

Description

On the contributor guide: https://docs.rc.uab.edu/contributing/contributor_guide/

Make the git workflow cycle more explicit and step-by-step at a high level.

One-time setup:

  1. Fork central repo
  2. Clone fork to local development environment (laptop, etc.)

Cycle to start a new feature:

  1. Sync fork from central
  2. Pull from fork to local
  3. Checkout main branch
  4. Create and checkout a new branch feat-...
  5. Perform development cycle (change, test, commit)
  6. Resync (1 & 2 again) and deal with any conflicts
  7. Push branch to fork
  8. Make pull request from fork to central

Then explain how to do each step in detail in separate sections.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the contributor guide at https://docs.rc.uab.edu/contributing/contributor_guide/ and review its existing git workflow. Make the setup and feature-cycle steps explicit in the listed order, then add separate sections explaining each step; the work is done when a newcomer can follow the full cycle from fork setup through pull request.

Written by the indexing model from the issue text.

Assessment

Tech stack
git
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.