Skip to content

Add document on how to submit patches #204

Merged
merged 11 commits into from
Dec 5, 2016

Conversation

pmenzel
Copy link
Collaborator

@pmenzel pmenzel commented Nov 17, 2016

Copy the document SubmittingPatches from the git project, and adapt it to our needs.

@pmenzel pmenzel force-pushed the add-document-on-how-to-submit-patches branch from 474887e to 8bb1972 Compare November 17, 2016 14:16
@pmenzel
Copy link
Collaborator Author

pmenzel commented Nov 17, 2016

@all, please comment this suggestion.

@donald
Copy link
Collaborator

donald commented Nov 23, 2016

Paragraphs "Decide what to base your work on" and "GitHub-Travis CI hints" don't apply here, do they?

This paragraph doesn’t apply to us, so remove it.
Although useful, we are not there yet, so remove the paragraph.
GitHub support Markdown, and it is pretty popular, so use it here too.
@pmenzel
Copy link
Collaborator Author

pmenzel commented Nov 23, 2016

@donald, I deleted the paragraphs, and converted the document to Markdown markup language.

@@ -0,0 +1,122 @@
Here are some guidelines for people who want to contribute their code
to this software.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"this software" ? A bunch of bee-files isn't software. 'bee-files' is not a software project but a collection of bee-files.

also I find the name SubmittingPatches misleading. "Hey, your bee-file is buggy, take this patch and fix it".

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I totally agree. Looking at the userbase, I’d argue the document is good enough for a start, and can be improved over the time.

These paragraphs talk about descriptive text not about commit
separation.
The section was reduced to its header, so we make the section into
a normal paragraph
We are talking about commits here now, not just about description.

At the same time make the first occurence of "the commit" to
"each commit" so readers don't get irritated by the wrong
grammatical number.
@donald
Copy link
Collaborator

donald commented Dec 5, 2016

ping

@pmenzel
Copy link
Collaborator Author

pmenzel commented Dec 5, 2016

Looks good to me from my side. Despite there are also commits from myself, I’ll merge it, as there has been enough time to review this.

@pmenzel pmenzel merged commit 53d7d4e into master Dec 5, 2016
@donald donald deleted the add-document-on-how-to-submit-patches branch December 14, 2016 14:34
Sign in to join this conversation on GitHub.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants