From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <ffmpeg-devel-bounces@ffmpeg.org>
Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100])
	by master.gitmailbox.com (Postfix) with ESMTPS id C70AE4E8C1
	for <ffmpegdev@gitmailbox.com>; Thu,  8 May 2025 11:13:50 +0000 (UTC)
Received: from [127.0.1.1] (localhost [127.0.0.1])
	by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 150B668C087;
	Thu,  8 May 2025 14:13:45 +0300 (EEST)
Received: from NAM12-DM6-obe.outbound.protection.outlook.com
 (mail-dm6nam12olkn2018.outbound.protection.outlook.com [40.92.22.18])
 by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id BD5D268B2C3
 for <ffmpeg-devel@ffmpeg.org>; Thu,  8 May 2025 14:13:38 +0300 (EEST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none;
 b=P/1X+R5Dv2ojqntJFgSH59EXAvgHojHbhtmuKMbaiQ3oXNjNLte1q8RPVO7POcFuCEy2U4iT2RpjoLcUHO3xIih6MeLE2+mfadnXMnvWt5DmIUWM7nDbwW/wzpriwMdDaFNIe36F5Jl21XMnrl4MGotJZB6uNgyVM5DFcytWCrA/ivahYa5oQVQMkKLJPQHEGuEyJnFx3McBZYZuXGZ12SeTElYAZ/xYBAa39a63NA8vuSFNo5/8PV8aZkldhVvapg4O3sEKC5qAmt52BvOqGZmLYphKMPqaLESuuv49EzxllDnsc2GPlUKFzUdpNUjbDMh33c+MjWbvKAyoADqeqg==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; 
 s=arcselector10001;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;
 bh=jhnhoxjONW6XPSweRLXi1dzimZxQF9OvtWcpMcr+/7Q=;
 b=VLADMIeBqii1P3IxwwuwcAPJkvGBjlJHitRAoEnMFfTLcCAxRxlXkyh/FH2JjJKTa3UmC0IlCymWhxmO1XX3t2KLSg8J/vkOK/nfD18Xb0ZJRjmkKxIzUlxoF7PwblgZpKpCvZAvAG6UsYTNTicKzTRweHsZczW/TYHXSCmnoDz0Amniyxu0gxuS8fAyGJ7aknFJ83nZVrBIvZkPHYK7+MtN9rFpwXN1bj/oJQt1Bw1PMTxWRiFM3v3rcGO1Encidjms/1ZQ7Ikg+x2oSCogtZ8xfOqbDNAYbvDJCbTyPrdnsKnjqhI8GJq+r8bT0bdHuStQOcoFOvH5i/hmibJAYA==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none;
 dkim=none; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=hotmail.com;
 s=selector1;
 h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;
 bh=jhnhoxjONW6XPSweRLXi1dzimZxQF9OvtWcpMcr+/7Q=;
 b=kiaenvk95dAqIoSZTie9V9TGijcg95shXcRjNMHoXmOBLBpyZyfHqAJt+rtFAiA/0t481QO9qmFnVbFzPId9kXEATfh8hBZREPUwd4kHxcMGc0fxA3PGFmu92wW91qSGGMM1oANA/g+7CgbxJbv6S9f8OE0MPBKSjCp+ifbJXffDBky21Zi+0QjgDn5aQBG/GBC9oOWadSQ45bds9wdogblOzcHlWNeYyOUZ51AFw9RKmVWatjRQZn+LAZvx3Ok8qmCcfYeuBM88lMJn/tDd9eoWclHiFHnxDl3xuSCp6kW4dc4qg5c/fRAFVerWOuO9JU/gkXk8FqTNQHHbc4v0hQ==
Received: from DM8P223MB0365.NAMP223.PROD.OUTLOOK.COM (2603:10b6:8:b::20) by
 PH3PPF8BE979C90.NAMP223.PROD.OUTLOOK.COM (2603:10b6:518:1::52e) with
 Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8722.23; Thu, 8 May
 2025 11:13:32 +0000
Received: from DM8P223MB0365.NAMP223.PROD.OUTLOOK.COM
 ([fe80::bf09:8e9:b07f:98a7]) by DM8P223MB0365.NAMP223.PROD.OUTLOOK.COM
 ([fe80::bf09:8e9:b07f:98a7%4]) with mapi id 15.20.8722.020; Thu, 8 May 2025
 11:13:32 +0000
From: "softworkz ." <softworkz-at-hotmail.com@ffmpeg.org>
To: ffmpegagent <ffmpegagent@gmail.com>, "ffmpeg-devel@ffmpeg.org"
 <ffmpeg-devel@ffmpeg.org>
Thread-Topic: [PATCH 0/5] doc/developer: Add subsection about patch submission
 via FFstaging
Thread-Index: AQHbwAMfz9mT0RnSXUOKfOhfHGnqObPIk/sw
Date: Thu, 8 May 2025 11:13:31 +0000
Message-ID: <DM8P223MB036538CF33E822F57AC5C619BA8BA@DM8P223MB0365.NAMP223.PROD.OUTLOOK.COM>
References: <pull.76.ffstaging.FFmpeg.1746699749.ffmpegagent@gmail.com>
In-Reply-To: <pull.76.ffstaging.FFmpeg.1746699749.ffmpegagent@gmail.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
x-ms-publictraffictype: Email
x-ms-traffictypediagnostic: DM8P223MB0365:EE_|PH3PPF8BE979C90:EE_
x-ms-office365-filtering-correlation-id: 702e2731-c0cd-4953-de8e-08dd8e215e08
x-ms-exchange-slblob-mailprops: obhAqMD0nT+76ZruCrigLPUIQMEMZUn+UHXTLSeegXB/8S+3DbwNt7QwVAXKJQpqnwa5olLUE4boy2ClX86jbtTfcp67ur/x5Kvj7j7m6XSgG/misc6806D76ROlEKuymRgDbz4KK2lRGO6j9/JFOBtI+W3hx/OanjwrASGidBgAOhh6eGEGjispVbiq/pyZ1qLlAh2eUHZij7Z3uo9cHWbZArKcPNkRuuLc3uXsXIVvSroETkUg7NeTu5/9nqjuLw9ntabetC49fJKXZesApOSEV6NarY/89iAuwaMdOM/xAblJ20sqtd6977VDrMEmOAGdaBV4eygj+DZEaNNdBrSl/l9dQbJRkKHVq99XLeA5/3EQBVEjsJTvbmx3LoWwBpgeXdWWqAOo1GSSfAVew6cUr5jQXoQbqWYETXaDRnR4Tsln6NpEuwwBxr6rdpFhEYE+NIgxd00dh6QngCKCve1lSi9rufZllgXdjvjyc0VfdEdcfVort9uy8bU0I5YM+79SKbNwj1/IyFJam1HSDHO26c1stUtX+kG/uv7eZDqulULyT+HW/GF9HrZaqh210UzgOWJYNbmEiMmMjh0acvq6Oy9HNWDmv/BXXkVrCgvel3nr9YiJiwaHItgppe4ETc9lLfyOkWuGbfV03mPFmsXNxql/ind6cG2MfOhgnqccLeaFunL+xeBYkVrz4sNCQfv7wHEoHMHJQ0Dt94pakbBK6VjXmxhv3V5gjz8K4fFaULHzHX57lXZdoiyX9mclRXvQStiAQkEPHYP1Rsf/6fZso+tvhOGO7qfrwdN5uYpKNp984ibpUT4HjV/2zeAC
x-microsoft-antispam: BCL:0;
 ARA:14566002|461199028|19110799006|15080799009|8060799009|7092599006|8062599006|1602099012|440099028|3412199025|4302099013|34005399003|102099032|12091999003|10035399007;
x-microsoft-antispam-message-info: =?utf-8?B?VzV0aFZmeTdLc2xpalNnSjdSWUpFTm5ZWXlaWkVUTWJSYXVNNXo5OG9ES0o2?=
 =?utf-8?B?M3lGZDIrVFRpRkM3aHVsZUdYL0g0bGxxZHBzZk1zRmZ3OEZRZi9ldklHWGdj?=
 =?utf-8?B?VXdMdFRWd0kzajlXY0QxM0MyaEx2cFQ1MUp4bUhueWVTbTlzcWphVm9zd01v?=
 =?utf-8?B?YXhNTE9ReDFBcitBMzNkQUMwaDg3elRUejRPeGEyNlRGUkZFL0RqSkpyUVpr?=
 =?utf-8?B?MTlqZmMzejE4L2pJSVlpcm0ySloybm1aYkJ4RjMySkhlTUthY3dQZkU3OVlN?=
 =?utf-8?B?Q241NFNSbFgwVGl1NVZMS3dOaGR2eEhwRit1c3UrendrbXgwanVTaWd2dnhW?=
 =?utf-8?B?cHVqS3E0YWVGM0ZlZXNiaENWWTJFazNQYjE3cWRMaEd2dmwveUl4YXdRZ1Ro?=
 =?utf-8?B?T0gvc2VtTkpNOFdibzJzTEszSWcwL1lPL3ArZ3MvY0o0WDYyeEdkR0dpWERa?=
 =?utf-8?B?QW1nQUo3RzNleDdUbllOUmRzLzVxWk82Y281UWJ1d0xMWk84czV3SjEzYmx5?=
 =?utf-8?B?a2UwQnlIT2F4dkNDQWZQQTBUZUxOMXJYWXBjMy9RZ25jeSsvWk5OQWkwR2NO?=
 =?utf-8?B?WHBubWN6UDlHS1g1NWkrdU9hTXZXVm9iK2FVLzIxdDJSMTlWNW9ERDdMYWZX?=
 =?utf-8?B?VVVHMDd4RkJFYTNHbG1SeTBtemZEa2FBTnZvYUlEbnpWNGM3VTNqTmgzWWxu?=
 =?utf-8?B?ZjBrcTdtSjh4cEpXWGVBaWM2WEJDRTJHdEo1a2VkVTdmc25pc2UrbW1VM2Zu?=
 =?utf-8?B?U1lGblFDcHo0cWpkWUFvakpXR2FUTFpxU2QzSnFkNG9WcVBjempFc3ZrS0gx?=
 =?utf-8?B?WDJzTENiU1pvaUg4OW51V0kvQUlLMGVVa2Vwa3NEQzY0NWUxS05RQVo0Zkta?=
 =?utf-8?B?ZFFpSlBFZng5TjFhZUt1VDJ1Sm82TG1UZWNjQ3g4SEhHZnBVWVRVUmxJL0M4?=
 =?utf-8?B?MWNiY3crakpNTzVlT2xJbjJ4YWZ1dUg2RHFlTko5OXR4WENLQXJIK3BUR3d2?=
 =?utf-8?B?VGNkZFJZZkNEUjVpeGFzdkZTVFl0OHU3R2luTmdpZjJ1VnpPNHdiTGkyNmY5?=
 =?utf-8?B?aUlFNDREM1hpbE5YTk5LV09ncDFVdlUvaDBEU1EvSy90QXFpdGRISmZWS3Bo?=
 =?utf-8?B?RkJTRStMdi81QXk2eTFCdGRKN1NZcVJhSTRLL1B0WStxRjhraWhrOGVqcVZE?=
 =?utf-8?B?eEFkYThYYm1BcHNkK1ZXSHlYK09Va1Q5bXE0QnpYYmFhZzVCNStXcnhteEdY?=
 =?utf-8?B?WkdzWHFoZWlQUjRIbEUybmFHVXZ6YU1QS09JeVR2SlkrV2l2alBsaUdmc3dE?=
 =?utf-8?B?N2RtN0lSZllkZDJsQ05qRDlGQnhjQjBndFJVdW4vcW1tL2p6eS9hbVNLdTNu?=
 =?utf-8?B?dXJ4OEZLd0tEMGVXdW15QnQ3NkJjV01aaEMyU2cwa0N4dnBDTFlvQ2JsOXZ2?=
 =?utf-8?B?UXN2Wlk2UnJZdUlnd0Nja0cvRGVmdGdmeVZCdG1WbmhxN0Y4NjkzTW0xNzZq?=
 =?utf-8?B?YWlOM29QOHBFRHY5c3JuMlV1dk4rV3VjYlpLZjM2VHRhZkdRRThsWnYwUWFI?=
 =?utf-8?B?RGlGSFlVdkVEdTRJK1RyL2tVY0lITmZXeDJVNnZhc2E3d2NlRlIzWktuNmpM?=
 =?utf-8?B?S05TUGZYNUFGUHM0MXNLKythaTNHWURxWjNocFNCMWVEaFZyWlhWY1RSSTFk?=
 =?utf-8?B?WU5nTm84RVRZcGxVVHVjRU8rbVZsaVdnS2hDWTBzQnUrRFI5ejRaQ1hnPT0=?=
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?utf-8?B?eFZqR0pzMHdJVHUvYUluMkRETzFIR3ZKb0ZvQ21lRHMvQ0xaS09EQUN0WGFI?=
 =?utf-8?B?czhUR2RmQ1lRdUlLRG0zL2RodnEyMlQ1TDRFa0R1RUxPdTdmWXllTHVxUkVY?=
 =?utf-8?B?dmt0bmw2YUhzOVhYNnZXUnZ0cXNxRWRCR1dpQVpEdSt5SWdJL2FIMnVVTTJk?=
 =?utf-8?B?NDRNSTlqbUdrb0I4YnJrS1pBVkl0U0UwZ3VRYXdSa3A2ZVprSjJ5VkM3ZkZY?=
 =?utf-8?B?VUpPM010OUMraEU4ZWgyUC9US3plenZhRUpCRFJSLy9Wb2UzeTRJOVNFOVpG?=
 =?utf-8?B?dXhPd1hKWmF5VnNSLzNFVWdXT3Z1MzRlVzhIb0ZzbFM0SVA0SzJnUEthRGsy?=
 =?utf-8?B?bDQ3NjU0b1JpMEwvMVQ0SGRWcmZmNG1tQkV1ZnJJVUJKSFpsUkhxY09HNnI4?=
 =?utf-8?B?MG02MDc1ZnZIMmpVblBUS3VHTXR1UGhqWGJVbmZ3cXhxTWliTUJEdzYvVkFD?=
 =?utf-8?B?MlVhUUR6eDJNSWNSaGF3ZHNSZnlnRG42cWkxaVNiVG4xY1RGZnFCbnJvSHZq?=
 =?utf-8?B?ZWQrczJ4NXUyeGVXMzkzSlh1Q1FtZHRuZjhuZmx2bERpUW1mOERSTEtjOFdM?=
 =?utf-8?B?WHB6bHVEaHRKdGJZWExZMkVhYmN2djZ1SzdWL2twKzhpWlRzVVZ6a093VDBX?=
 =?utf-8?B?SDRTbVV1ZnBsRGQycnV4WjBlUGp1ZjBHMEFLTHB5RDNvRExLZS9NZlJiWEpE?=
 =?utf-8?B?d1UwQWZhN25rSC9TUkxOc3FiSW44K3lqOXZMbUkwb3huMjZvRmx0SjlLTXV0?=
 =?utf-8?B?UTNvc0x1MjJ2OXdvWXlTMytSa09hMEFmOFhTS1pZM1p3TlIwdEM2NWVYY0lD?=
 =?utf-8?B?M01HSnRjTjY4Q296VlY5TkNZakdLZzhGbkVnOU5KZFZSRThVYU1XTVRtQUZZ?=
 =?utf-8?B?bXRQN3FsZ0xvT2VYK2VzemQxVXhkVDdoc2J1eDVIb2hxemJpSXFOMCthU0JF?=
 =?utf-8?B?N3FZMXMrK0p6NEJtRDN2TXcvaEhpZTNlWDl1S0xGeCtkVU9JdDVCVVM1b2ZQ?=
 =?utf-8?B?Qzh3cWMrMUVJNnVuSWljbUJRaXdGV2IrTmFvRktEL0xjc1hwc3hEL0tRSk9p?=
 =?utf-8?B?cWdvdVlFNVh0QXA1Mm13V2dTSWgyZTNjam5vaUhVYWJRTlpqWUYyczVCN0Fy?=
 =?utf-8?B?OG1XdkVhRldnM2hpaElhbzJWWVF1cFJVbTBvNGJwbWk4bVdGbXJSay9NM0Qr?=
 =?utf-8?B?RVg1Umlwc2IzS0FzUS9RTVMrRjE2VVRBR3BCdzBCUVBOMWlMRXdJaEduQUp4?=
 =?utf-8?B?YnN6ek9hWDhyQ09nY2paS0lhTmdGYXhJNlpTL0t1cnR5SVpZUXVjZDE4NjRq?=
 =?utf-8?B?bm5RVkFBUzZ3VU5nUkhmSnkzR1NMUGpqOWt1dFJXdm1RRkllUHkzZzRSalA1?=
 =?utf-8?B?LzNRT1orQU1OTkFzRndYWGpkdEJoU3RQak9BbnowQmhNbXhzTU4vcHNORDJn?=
 =?utf-8?B?MjhlRGZIZzc3Z0JiZmtPeGEyOFdjeEVabGxZMmQzVXI3SlhtL3dQaUJiUkdk?=
 =?utf-8?B?Sk9Bam5leGtpV0VlU2tiT3lPRllCMm9yZnRic0VOVXRTalExWUE4N1I3cmNL?=
 =?utf-8?B?QTdrVHpvVE5GZWxSQXhiaGZKeVpLbjJ2UWpIODlyN2ZDUnJOank2ejZUOTJJ?=
 =?utf-8?Q?UewEPEIAOSrZZFXBzrpv/M8pHCOn0IMRtT5hwzFyEq0k=3D?=
MIME-Version: 1.0
X-OriginatorOrg: sct-15-20-7719-20-msonline-outlook-92255.templateTenant
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: DM8P223MB0365.NAMP223.PROD.OUTLOOK.COM
X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000
X-MS-Exchange-CrossTenant-Network-Message-Id: 702e2731-c0cd-4953-de8e-08dd8e215e08
X-MS-Exchange-CrossTenant-originalarrivaltime: 08 May 2025 11:13:31.8809 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa
X-MS-Exchange-CrossTenant-rms-persistedconsumerorg: 00000000-0000-0000-0000-000000000000
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH3PPF8BE979C90
Subject: Re: [FFmpeg-devel] [PATCH 0/5] doc/developer: Add subsection about
 patch submission via FFstaging
X-BeenThere: ffmpeg-devel@ffmpeg.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: FFmpeg development discussions and patches <ffmpeg-devel.ffmpeg.org>
List-Unsubscribe: <https://ffmpeg.org/mailman/options/ffmpeg-devel>,
 <mailto:ffmpeg-devel-request@ffmpeg.org?subject=unsubscribe>
List-Archive: <https://ffmpeg.org/pipermail/ffmpeg-devel>
List-Post: <mailto:ffmpeg-devel@ffmpeg.org>
List-Help: <mailto:ffmpeg-devel-request@ffmpeg.org?subject=help>
List-Subscribe: <https://ffmpeg.org/mailman/listinfo/ffmpeg-devel>,
 <mailto:ffmpeg-devel-request@ffmpeg.org?subject=subscribe>
Reply-To: FFmpeg development discussions and patches <ffmpeg-devel@ffmpeg.org>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: ffmpeg-devel-bounces@ffmpeg.org
Sender: "ffmpeg-devel" <ffmpeg-devel-bounces@ffmpeg.org>
Archived-At: <https://master.gitmailbox.com/ffmpegdev/DM8P223MB036538CF33E822F57AC5C619BA8BA@DM8P223MB0365.NAMP223.PROD.OUTLOOK.COM/>
List-Archive: <https://master.gitmailbox.com/ffmpegdev/>
List-Post: <mailto:ffmpegdev@gitmailbox.com>



> -----Original Message-----
> From: ffmpegagent <ffmpegagent@gmail.com>
> Sent: Donnerstag, 8. Mai 2025 12:22
> To: ffmpeg-devel@ffmpeg.org
> Cc: softworkz <softworkz@hotmail.com>
> Subject: [PATCH 0/5] doc/developer: Add subsection about patch submission via
> FFstaging
> 
> Signed-off-by: softworkz softworkz@hotmail.com
> 
> softworkz (5):
>   doc/developer: Move checklist into Submitting Patches chapter
>   doc/developer: Move codecs/formats checklist into Development Policy
>     chapter
>   doc/developer: Reorder Submission procedures content
>   doc/developer: Merge Review paragraphs and deduplicate
>   doc/developer: Add subsection about patch submission via FFstaging
> 
>  doc/developer.texi | 234 ++++++++++++++++++++++++---------------------
>  1 file changed, 127 insertions(+), 107 deletions(-)
> 
> 
> base-commit: 1b643e3f65d75a4e6a25986466254bdd4fc1a01a
> Published-As: https://github.com/ffstaging/FFmpeg/releases/tag/pr-ffstaging-
> 76%2Fsoftworkz%2Fsubmit_website_update-v1
> Fetch-It-Via: git fetch https://github.com/ffstaging/FFmpeg pr-ffstaging-
> 76/softworkz/submit_website_update-v1
> Pull-Request: https://github.com/ffstaging/FFmpeg/pull/76
> --
> ffmpeg-codebot


Forgot so save the cover letter text before submitting:


The https://ffmpeg.org/developer.html (doc/developer.texi) page contains a lot of good information but there's some structural and contentual duplication that is begging for cleanup:

[3 Development Policy](https://ffmpeg.org/developer.html#Development-Policy-1)
[4 Submitting patches](https://ffmpeg.org/developer.html#Submitting-patches-1)
[5 New codecs or formats checklist](https://ffmpeg.org/developer.html#New-codecs-or-formats-checklist)
[6 Patch submission checklist](https://ffmpeg.org/developer.html#Patch-submission-checklist)
[7 Patch review process](https://ffmpeg.org/developer.html#Patch-review-process)

- a Patch submission checklist clearly belongs to the context of  "Submitting Patches"
- a checklist about the requirements for adding new codecs/formats is mostly a matter of policies
- after moving 5 into 3 and 6 into 4,  another duplication can be resolved elegantly as 4 ends with a section about patch reviews which is then adjacent to the current 7 (patch review process)
- inside 4:
  - some duplication between 4's intro and the checklist can be removed
  - the second part becomes "Submission procedures" with three subsections (send-email, format-patch and FFstaging) and the content separated in a more logical way


Thanks
sw
_______________________________________________
ffmpeg-devel mailing list
ffmpeg-devel@ffmpeg.org
https://ffmpeg.org/mailman/listinfo/ffmpeg-devel

To unsubscribe, visit link above, or email
ffmpeg-devel-request@ffmpeg.org with subject "unsubscribe".