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

[Tom Rini]

On Wed, Feb 01, 2023 at 01:20:52PM -0700, Simon Glass wrote:
> Hi Heinrich,
> 
> On Sun, 29 Jan 2023 at 15:37, Heinrich Schuchardt
> <heinrich.schuchardt at canonical.com> wrote:
> >
> >
> >
> > 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?
> 
> I was hoping you might, since you are wanting to remove what is there,
> which I think is better than nothing.

Having re-read the section that was removed, I agree with Heinrich here.
What was written 20 years ago, and still correct was too vague to be
useful.  Someone, anyone, writing something to put under doc/develop/
would be appreciated all the same.

-- 
Tom
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 659 bytes
Desc: not available
URL: <https://lists.denx.de/pipermail/u-boot/attachments/20230202/554b6967/attachment.sig>