On 2014-09-11 23:10, James Darnley wrote: > I support the change and I am willing to look at adding and adapting > some relevant points from the mplayer text.
Point 0, "diffs please", is covered by our request for git format-patch in the patch submission checklist[1] point 2 and the git how-to page[2] Point 1, "svn head", is covered by point 5 on the patch submission checklist[1]. Point 2, "unified diffs", is covered by out request for patches. Are we doing to allow git diff dumps? Point 3, "diff from tree root", I believe is covered by the request for patches again. Plus, I don't think git can successfully work if you aren't in the root. Point 4, "test", is covered by point 1 on the checklist[1], make fate. Point 5, "read your patch", is covered by the developer doc[3] section 1.5 in which we mention patcheck. The checklist[1] point 13 also mentions tabs and trailing white space. Point 6, "comment you code", is missing. I don't think we state that complex code and code with side effects should be commented. Point 7, "document changes to behaviour", is covered by the development policy section[4] point 14. Perhaps point 20 on the checklist[1] too. Point 8, "split patches", is covered by the dev policy[4] point 5. Point 9, "how to send patches", should be mostly covered by the request to use git send-email. It also also asked that only one attachment is added in [4]. Since we tolerate attached patches we could adapt this into a section somewhere. Point 10, "please wait", is covered by [4] but could also be added to the patch review process section [5] Point 11, "don't expect write access", is not mentioned anywhere as far as I can tell. Point 12 is just wrong. We use underscores not hyphens in command line options. This fact does need to be mentioned somewhere though. Point 13 is also inaccurate because we don't have an AUTHORS file. Should this refer to the file's copyright header? Point 14, "no printf", is covered by miscellaneous conventions[6] and our code itself. Reviews should catch people overriding this. Point 15, "resend whole patches", this is missing. Could be added in a couple of places. Overall, not a lot to do just some. Points 6, maybe 9, 10, 11, 12, 13, and 15 need some text adding to our own docs. I'll try submit some patches for consideration either soon tonight or within ~24 hours. [1] http://ffmpeg.org/developer.html#patch-submission-checklist [2] http://ffmpeg.org/git-howto.html#Sending-patches-for-review [3] http://ffmpeg.org/developer.html#Submitting-patches-1 [4] http://ffmpeg.org/developer.html#Development-Policy [5] http://ffmpeg.org/developer.html#Patch-review-process [6] http://ffmpeg.org/developer.html#Miscellaneous-conventions
signature.asc
Description: OpenPGP digital signature
_______________________________________________ ffmpeg-devel mailing list ffmpeg-devel@ffmpeg.org http://ffmpeg.org/mailman/listinfo/ffmpeg-devel