netdev - Re: [PATCH 2/2] bpf, doc: split general purpose eBPF documentation out of filter.rst

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20211119061642.GB15129@lst.de>
Date:   Fri, 19 Nov 2021 07:16:42 +0100
From:   Christoph Hellwig <hch@....de>
To:     Alexei Starovoitov <alexei.starovoitov@...il.com>
Cc:     Christoph Hellwig <hch@....de>, Jonathan Corbet <corbet@....net>,
        "David S. Miller" <davem@...emloft.net>,
        Jakub Kicinski <kuba@...nel.org>,
        Alexei Starovoitov <ast@...nel.org>,
        Daniel Borkmann <daniel@...earbox.net>,
        Andrii Nakryiko <andrii@...nel.org>,
        Martin KaFai Lau <kafai@...com>,
        Song Liu <songliubraving@...com>, Yonghong Song <yhs@...com>,
        John Fastabend <john.fastabend@...il.com>,
        KP Singh <kpsingh@...nel.org>, linux-doc@...r.kernel.org,
        netdev@...r.kernel.org, bpf@...r.kernel.org
Subject: Re: [PATCH 2/2] bpf, doc: split general purpose eBPF documentation
 out of filter.rst

On Wed, Nov 17, 2021 at 04:56:13PM -0800, Alexei Starovoitov wrote:
> I think the split would be good in the long term, but please make the links
> more obvious somehow in the filter.rst, since a bunch of posts on the web
> link back to that file. The folks who will be reading the revamped filter.rst
> would need a very obvious way to navigate to new pages.

What would be a good way to make it more obvious?  Add a section with
links to the three new documentents and/or the Documentation/bpf/
index?

> In terms of followups and cleanup... please share what you have in mind.

The prime issue I'd like to look in is to replace all the references
to classic BPF and instead make the document standadlone.