Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 04A72C6FD19 for ; Mon, 13 Mar 2023 22:35:05 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229831AbjCMWfD (ORCPT ); Mon, 13 Mar 2023 18:35:03 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53492 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229684AbjCMWfA (ORCPT ); Mon, 13 Mar 2023 18:35:00 -0400 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AC39FE2; Mon, 13 Mar 2023 15:34:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:In-Reply-To:References:To:From:Subject:MIME-Version:Date: Message-ID:Sender:Reply-To:Cc:Content-ID:Content-Description; bh=iaCMT7ggspdCczav0w+cVCxC+t12vp04Dev0ax8lLKU=; b=tuFpon30c+3XHUn9ayObtszrTn PCEUy0LVHBPTqORsTIQPHpMYCRL61+TTYZt2IGEWwBwryuIYXRRPGQVoFoaNarq+pBTCZ69dw+XV7 2gzJzEVJxpZZ/x4N6X4q96reGDXjneU1m96+Gaur3B5xpnCv5uNYuFdOXBs5lYd99x/E04nR4lp88 E0yoFX9EfAg8tUKZ4gM4wkzKbFU5vmCloRcb5qz84PuMzIFqjt2PMEMzlu4gh2oJ+SHKVSlawKSey maZ3y/BhrvIeGaMigeINlAF13Ouq3Sdxz79JbbiVyyUXim9MCmfV29y1UoHmEIabAFZydwkHtut2U 56rvZOvg==; Received: from [2601:1c2:980:9ec0::df2f] by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1pbqkt-0085PU-8u; Mon, 13 Mar 2023 22:34:59 +0000 Message-ID: Date: Mon, 13 Mar 2023 15:34:58 -0700 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.8.0 Subject: Re: Documentation on IMA for Linux Kernel Documentation Content-Language: en-US From: Randy Dunlap To: Ken Goldman , linux-kernel@vger.kernel.org, linux-integrity@vger.kernel.org References: <7c91820d-0153-e4db-1c60-38b6f650ed20@linux.ibm.com> <60ac4c41-65b8-3c3d-7e31-1a580e728ca5@infradead.org> In-Reply-To: <60ac4c41-65b8-3c3d-7e31-1a580e728ca5@infradead.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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@vger.kernel.org -- ~Randy