[PATCH 1/1] README: remove 'U-Boot Porting Guide' section

Heinrich Schuchardt heinrich.schuchardt at canonical.com
Sun Jan 29 23:37:14 CET 2023



On 1/28/23 23:01, Simon Glass wrote:
> Hi Heinrich,
> 
> On Thu, 26 Jan 2023 at 02:17, Heinrich Schuchardt
> <heinrich.schuchardt at canonical.com> wrote:
>>
>> On 1/26/23 00:49, Simon Glass wrote:
>>> Hi Heinrich,
>>>
>>> On Wed, 25 Jan 2023 at 12:00, Heinrich Schuchardt
>>> <heinrich.schuchardt at canonical.com> wrote:
>>>>
>>>> This section does not match the standards of our documentation.
>>>>
>>>> Signed-off-by: Heinrich Schuchardt <heinrich.schuchardt at canonical.com>
>>>> ---
>>>>    README | 74 ----------------------------------------------------------
>>>>    1 file changed, 74 deletions(-)
>>>>
>>>
>>> It seems fairly accurate to me, and includes some good advice.
>>>
>>> Regards,
>>> Simon
>>
>> * That section tries to look funny. U-Boot is serious stuff.
> 
> Some people do have a sense of humour...but in any case it might be
> better to reword it to meet your standards, rather than delete it?
> 
>> * The information is outdated. BDI3000 is not on sale,
>> https://www.denx.de/wiki/bin/view/DULG/Manual is no longer maintained.
>> * It contains advice that we would prefer not to give like
>>     email("Hi, I am new to U-Boot, how do I get started?")
>> * It is incomplete. You cannot introduce a new board without defconfig.
>>
>> An introduction chapter for new developers in doc/develop/ would be helpful.
> 
> OK, so how about updating it, then? Having nothing at all seems bad to me.

As Tom wrote README should be minimal and point to the HTML 
documentation. So nothing to update here. Are you able to provide a 
chapter on porting boards?

Best regards

Heinrich


More information about the U-Boot mailing list