Two ideas for the http://drupal.org/project/drupal/git-instructions page:

First, I think it might be helpful if instead of "Version Control" for the Git Instructions tab, it said "Version Control (GIT)". If I'm looking for GIT instructions, I might miss it because GIT is not explicit in "Version Control" (which might also be confused with the "Revisions" tab right next to it).

Second, it would be GREAT to have the git pull --rbase (?) on this page. (It's the command demoed today in the newbie code sprint, especially because it seems I have remembered that command wrong.)

Comments

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Project: Documentation » Project Git instructions
Version: » 6.x-1.x-dev
Component: Correction/Clarification » Instructions

Moving to the project that generates the instructions.

eliza411’s picture

eliza411 commented
Title: Content problem - GIT instrutions page » Content problem - Git instrutions page
Status: Active » Closed (won't fix)

Thanks for the suggestions. It's helpful to post each issue individually so each can be resolved independently.

Version control tab
There's some history to the tab name at http://drupal.org/node/1164696, based on which I'm closing this issue as won't fix.

Rebasing
Rebasing is appropriate in certain contexts and detrimental to collaborative development in others. There was a lot of community discussion about when and where to rebase, much of it in IRC, unfortunately. It was ultimately treated as an advanced command, one that should not be used by people cutting and pasting and not knowing the implications of what rebase is doing (and therefore not on the Version control tab).

If you would write this request up in its own issue and describe the context for using rebase, keeping in mind that the goal of the tab is to include the absolute minimal instruction possible for the greatest number of users to be successful, we can see if there's been a shift in thinking.