Skip to content

Proposed Process update #34

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 4 commits into from
Closed

Proposed Process update #34

wants to merge 4 commits into from

Conversation

erica
Copy link
Contributor

@erica erica commented Dec 6, 2015

I found the original process.md document hard to follow. Here's a proposal for a more readable version.

@lattner
Copy link
Collaborator

lattner commented Dec 6, 2015

Please remove the process-original.md addition. @DougGregor should review this.

@erica
Copy link
Contributor Author

erica commented Dec 6, 2015

I think I did it right but I'm a complete moron when it comes to git (which is why all my repos have shell scripts). Can you please check and let me know if I did it or I need to do something more.

Thanks, -- E

On Dec 6, 2015, at 3:58 PM, Chris Lattner notifications@github.com wrote:

Please remove the process-original.md addition. @DougGregor https://github.com/DougGregor should review this.


Reply to this email directly or view it on GitHub #34 (comment).

@jessesquires
Copy link
Contributor

@erica 😆 Looks good, but you'll probably need to squash the 2 commits into 1.

@jackhl
Copy link

jackhl commented Dec 7, 2015

It might be worth having a quick DevPubs/editorial pass on this document.

@erica
Copy link
Contributor Author

erica commented Dec 7, 2015

Probably a good idea since I already see a few typos:

Is it an evolutionary change to the Swift language or Swift standard library public interface?
Is it a new language features or APIs? (no matter how small!)
Does it change existing language features and APIs?
Does it removal of existing features from the language?
should read

Is it an evolutionary change to the Swift language or to Swift standard library public interface?
Is it a new language feature or API? (no matter how small!)
Does it change any existing language features or APIs?
Does it propose removing existing features from the language?
-- E, who is very bad at (1) self-copy edits, and (2) writing in markdown

On Dec 6, 2015, at 7:39 PM, Jack Lawrence notifications@github.com wrote:

It might be worth having a quick DevPubs/editorial pass on this document.


Reply to this email directly or view it on GitHub #34 (comment).

@erica
Copy link
Contributor Author

erica commented Dec 7, 2015

I honestly have no idea how that is done. Any tips would be welcome.

-- E

On Dec 6, 2015, at 7:31 PM, Jesse Squires notifications@github.com wrote:

@erica https://github.com/erica Looks good, but you'll probably need to squash the 2 commits into 1.


Reply to this email directly or view it on GitHub #34 (comment).

@Danappelxx
Copy link

@erica You should read this, http://gitready.com/advanced/2009/02/10/squashing-commits-with-rebase.html but in essence:

  1. git rebase -i HEAD~2 - rebase the last 2 commits
  2. For the commit which you want to merge, change "pick" to "squash"
  3. Save & exit

@erica
Copy link
Contributor Author

erica commented Dec 7, 2015

I don't think I can be trusted with git.

@erica
Copy link
Contributor Author

erica commented Dec 7, 2015

I have deleted my fork. And re-submitted a separate pull request.

@erica erica closed this Dec 7, 2015
@lattner
Copy link
Collaborator

lattner commented Dec 7, 2015

On Dec 6, 2015, at 3:49 PM, Erica Sadun notifications@github.com wrote:

I think I did it right but I'm a complete moron when it comes to git (which is why all my repos have shell scripts).

FWIW, I have a hard time believing that anyone is a bigger git-moron than me. :-)

-Chris

@mcdado
Copy link

mcdado commented Dec 11, 2015

@erica allow me to humbly suggest that if you're not just doing everything via Github web interface, you could give GitUp a try, instead of the confusing command line git commands. GitUp gives you a very visual way to work with your local copy of the repository.

It uses some idioms and enables some actions that are not native to git, but they make a lot of sense:

  • rewriting commits: technically checking out a former commit and amending to it, then rebasing the following commits onto it. it enables you to correct a mistake or make changes to a previous commit.
  • edit commit messages: as simple as that sounds, edit the message of a previous commit
  • etc.

I need to warn though that this causes what is referred to as changing history, and it has nasty consequences if the commit in question is already merged or somebody else is basing work on top of it. As long as you're always creating a new separate branch on your fork for each single proposed change this should not be a problem (if you propose a change via Github, this is usually done automatically with patch-x branch names). You just need to force push to your own forked branch after performing one of the actions above.

After you start proposing a change via Github web interface, if you add your fork as a remote to your locally cloned repo, you'll be able to pull and push to the newly created branch by Github. So when somebody asks to rebase or change something, you don't need to create a new branch or redo the work: just make the changes locally and force push.

I hope I made myself clear enough, I'm sorry if I didn't 😉

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

7 participants