If there are no branches or tags to create a release from, the page tells us to "create either a new tag on one of the existing branches for this project, or you must add a new branch." It would be nice to have a link to the instructions on how to do that.

Maybe the instructions themselves don't need to be on the page, since once we do it a few times we'll know what to do, but a link would be nice for those first few times we do it.

Comments

eliza411’s picture

Assigned: Unassigned » eliza411

Thanks for bringing this up again. It needs to happen, but I'm not really sure a developer issue was ever opened, nor can I assure you it will in as timely a fashion as we might like, but it's important. Assigning to me until I'm sure it's represented in the developer queue.

dww’s picture

Assigned: eliza411 » dww
Priority: Minor » Normal

There was never an issue that I know of. If someone posts a link to the right documentation to link here, I'll add the link via a form_alter in drupalorg_project.

eliza411’s picture

I would link here: http://drupal.org/node/1015226 and make sure it cross-references the specific commands page (which it's not currently doing). There's still a lot of flux in the docs.

eliza411’s picture

Status: Active » Postponed
Issue tags: +git phase 2 leftovers

Another enhancement I'd like to see at the first opportunity after deployment, postponing and tagging for now.

darrellduane’s picture

+1
More than just a link to instructions, I'd encourage you to show a example tag/branch names:

Text such as:

Tags should be in the form of Drupal Dist-Project Release. Valid examples include:
7.x-1.0
7.x-1.0-beta5
7.x-2.0-alpha3

Branch Names should be in the form of Drupal Distribution-Project Distribution. An example is:
7.x-2.x (no need to include -dev, it will be appended automatically if the tag or branch name ends in .x)

For more details visit this page.

For a quick guide to adding tags and branches for Git on Drupal, visit this page.

dww’s picture

Priority: Normal » Major
Status: Postponed » Needs review
Issue tags: +Usability
StatusFileSize
new71.58 KB
new37.08 KB
new1.65 KB
new1.41 KB

This has pretty serious implications for the UX and support load we're going to get, so I'm bumping to major. Here's 2 patches (one to remove a // TODO from versioncontrol_release to make this text easily alterable, and then the altering itself in drupalorg_versioncontrol), plus before/after screenshots of how it looks in bluecheese. Mostly incorporated DarrellDuane's approach from #5 but with some edits.

dww’s picture

Wearing my UX hat, this is way too much text. Here's another version that clobbers the default text from versioncontrol_release (instead of appending to the end of it) and makes it all more concise. Also includes a link to the Git instructions tab. Same before and vc_release patch from #6. New patch for drupalorg_versioncontrol and new after.png.

webchick’s picture

*MUCH* better. I think that looks great.

Bojhan’s picture

No valid branches or tags found.

Your release needs to have a tag or branch that follows the naming convention and have no other release attached to it.

Valid release tag examples :

Valid release branch examples:

.....

Once you have added a valid branch or tag, try again.

dww’s picture

This implements Bojhan's suggestions (but leaving the actually error message itself bold), which I confirmed in IRC Bojhan is still happy with.

eliza411’s picture

This looks great to me, too.

Bojhan’s picture

Status: Needs review » Reviewed & tested by the community

:)

dww’s picture

Status: Reviewed & tested by the community » Fixed
Issue tags: -git phase 2 leftovers +git phase 2

Great! Committed #6 to HEAD of versioncontrol_project and #10 to DRUPAL-6--3 of drupalorg. Yay!

This is no longer a leftover. ;)

Status: Fixed » Closed (fixed)
Issue tags: -Usability, -git phase 2

Automatically closed -- issue fixed for 2 weeks with no activity.