linux-kernel - Re: Documentation on IMA for Linux Kernel Documentation

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: Windows password security audit tool. GUI, reports in PDF.

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

Message-ID: <c03bf464-00c1-9121-fb2f-549ac991a658@linux.ibm.com>
Date:   Wed, 22 Mar 2023 18:02:21 -0400
From:   Ken Goldman <kgold@...ux.ibm.com>
To:     linux-kernel@...r.kernel.org, linux-integrity@...r.kernel.org
Subject: Re: Documentation on IMA for Linux Kernel Documentation

On 3/13/2023 6:34 PM, Randy Dunlap wrote:
> On 3/13/23 15:25, Randy Dunlap wrote:
>> [add IMA list]
>>
>> On 3/13/23 14:43, Ken Goldman wrote:
>>> I'm writing documentation on IMA targeting users (not kernel developers).  It includes concepts, details on writing policies, the IMA event log format, utilities, and more.  It aggregates existing scattered documentation, but adds much more.  It's maybe 1/2 done.
>>>
>>> Questions:
>>>
>>> 1. Are there people who could look at it and see if I'm on the right path?
>>>
>>> It's a lot of work.  I'd like to know that it has some chance of acceptance.
>>>
>>> 2. What is the process for getting a block of documentation added to https://www.kernel.org/doc/html?
>>
>> It should be added to the kernel tree in the Documentation/userspace-api/ subdirectory
>> or Documentation/security/ subdirectory.  The kernel.org/doc/ web pages are generated
>> from what is in the Linux kernel tree.
> Ken, if you are not familiar with in-tree kernel documentation, you should take a look
> at the Documentation/doc-guide/ subdirectory for some documentation on the documentation.
>
> Also you can ask for help with specific issues at linux-doc@...r.kernel.org

I've read the guidelines, coding in rest markdown, using sphinx to test 
the web pages.  I think it's right.

1. I was hoping that someone could look at what I'm doing to see if it 
has a chance of acceptance.

I.e., I don't want to spend months on this only to get a quick 'nack'.

2. I wonder what the process for submission is.