From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from out01.mta.xmission.com (out01.mta.xmission.com [166.70.13.231]) by mx.groups.io with SMTP id smtpd.web11.11885.1636551609777701255 for ; Wed, 10 Nov 2021 05:40:09 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@bsdio.com header.s=xmission header.b=d1l7lkk2; spf=none, err=SPF record not found (domain: bsdio.com, ip: 166.70.13.231, mailfrom: rebecca@bsdio.com) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=simple/simple; d=bsdio.com; s=xmission; h=Subject:Content-Transfer-Encoding:Content-Type:In-Reply-To: MIME-Version:Date:Message-ID:From:References:To:Sender:Reply-To:Cc:Content-ID :Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To: Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:List-Subscribe :List-Post:List-Owner:List-Archive; bh=2E9Pul/CXoS/pQdLuElClCSuqqV8qznq/GN1XgacP4o=; b=d1l7lkk2cEhCQLVe1am6V4Rzof Pq8sC/aKB+hOUbgfbsvqDEk2iv07aSWEh1OHn1zfuRYxGE/Rau/0Eyr8Q6eVuvbEVml2TMg6NqtiA pZfRCRVFICeioWby5f5LWrJ8fJwH6AjbzS4Z5jowMV2gOiS1yu6ovAxF5plFLQ5vNgEo=; Received: from in02.mta.xmission.com ([166.70.13.52]:38244) by out01.mta.xmission.com with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.93) (envelope-from ) id 1mknpf-00CWya-Rs; Wed, 10 Nov 2021 06:40:07 -0700 Received: from mta5.zcs.xmission.com ([166.70.13.69]:49736) by in02.mta.xmission.com with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.93) (envelope-from ) id 1mknpd-006GtZ-PQ; Wed, 10 Nov 2021 06:40:07 -0700 Received: from localhost (localhost [127.0.0.1]) by mta5.zcs.xmission.com (Postfix) with ESMTP id 8E8121280F79; Wed, 10 Nov 2021 06:40:05 -0700 (MST) X-Amavis-Modified: Mail body modified (using disclaimer) - mta5.zcs.xmission.com Received: from mta5.zcs.xmission.com ([127.0.0.1]) by localhost (mta5.zcs.xmission.com [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id nx-JAcuUc1AM; Wed, 10 Nov 2021 06:40:05 -0700 (MST) Received: from [10.0.10.179] (c-174-52-16-57.hsd1.ut.comcast.net [174.52.16.57]) by mta5.zcs.xmission.com (Postfix) with ESMTPSA id 538A71280F04; Wed, 10 Nov 2021 06:40:05 -0700 (MST) To: discuss@edk2.groups.io, michael.d.kinney@intel.com, "devel@edk2.groups.io" References: <30cc16f7-0804-7e16-ba78-089b6d338449@bsdio.com> From: "Rebecca Cran" Message-ID: <31e7130e-958a-a026-0b17-43ee57ea6773@bsdio.com> Date: Wed, 10 Nov 2021 06:40:05 -0700 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.13.0 MIME-Version: 1.0 In-Reply-To: X-XM-SPF: eid=1mknpd-006GtZ-PQ;;;mid=<31e7130e-958a-a026-0b17-43ee57ea6773@bsdio.com>;;;hst=in02.mta.xmission.com;;;ip=166.70.13.69;;;frm=rebecca@bsdio.com;;;spf=none X-SA-Exim-Connect-IP: 166.70.13.69 X-SA-Exim-Mail-From: rebecca@bsdio.com X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on sa06.xmission.com X-Spam-Level: X-Spam-Status: No, score=0.4 required=8.0 tests=ALL_TRUSTED,BAYES_50, DCC_CHECK_NEGATIVE,NICE_REPLY_A,TR_XM_BayesUnsub,T_TM2_M_HEADER_IN_MSG, TooManyTo_001,TooManyTo_002,TooManyTo_003,XMSubLong,XM_B_Unsub autolearn=disabled version=3.4.2 X-Spam-Report: * -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP * 0.8 BAYES_50 BODY: Bayes spam probability is 40 to 60% * [score: 0.5001] * 0.7 XMSubLong Long Subject * 0.3 TooManyTo_001 Multiple "To" Header Recipients 2x (uncommon) * 0.6 TooManyTo_003 Multiple "To" Header Recipients 4x (uncommon) * 0.5 TooManyTo_002 Multiple "To" Header Recipients 3x (uncommon) * 0.0 T_TM2_M_HEADER_IN_MSG BODY: No description available. * -0.0 DCC_CHECK_NEGATIVE Not listed in DCC * [sa06 1397; IP=ok Body=1 Fuz1=1] [Fuz2=1] * 0.5 XM_B_Unsub Unsubscribe in body of email but missing unsubscribe * header * -3.5 NICE_REPLY_A Looks like a legit reply (A) * 1.5 TR_XM_BayesUnsub High bayes score with no unsubscribe header X-Spam-DCC: XMission; sa06 1397; IP=ok Body=1 Fuz1=1 Fuz2=1 X-Spam-Combo: ;discuss@edk2.groups.io, michael.d.kinney@intel.com, "devel@edk2.groups.io" X-Spam-Relay-Country: X-Spam-Timing: total 1531 ms - load_scoreonly_sql: 0.04 (0.0%), signal_user_changed: 12 (0.8%), b_tie_ro: 10 (0.7%), parse: 1.17 (0.1%), extract_message_metadata: 25 (1.7%), get_uri_detail_list: 3.7 (0.2%), tests_pri_-1000: 24 (1.6%), tests_pri_-950: 1.27 (0.1%), tests_pri_-900: 1.05 (0.1%), tests_pri_-90: 111 (7.2%), check_bayes: 98 (6.4%), b_tokenize: 9 (0.6%), b_tok_get_all: 9 (0.6%), b_comp_prob: 3.3 (0.2%), b_tok_touch_all: 73 (4.7%), b_finish: 0.97 (0.1%), tests_pri_0: 1343 (87.7%), check_dkim_signature: 0.59 (0.0%), check_dkim_adsp: 36 (2.3%), poll_dns_idle: 26 (1.7%), tests_pri_10: 2.1 (0.1%), tests_pri_500: 9 (0.6%), rewrite_mail: 0.00 (0.0%) Subject: Re: [edk2-discuss] [edk2-devel] EDK2 doxygen documentation - adding docs for stable tags? X-SA-Exim-Version: 4.2.1 (built Sat, 08 Feb 2020 21:53:50 +0000) X-SA-Exim-Scanned: Yes (on in02.mta.xmission.com) Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Content-Language: en-US How easy it is to push changes to https://www.tianocore.org/ ? I had thought that given how infrequently it's updated it's rather difficult, but I agree that's the ideal location for the Doxygen pages. If it's easier than I think, I have other changes I'd like to make such as updating https://www.tianocore.org/news/ which hasn't been changed since 2018. I agree it would be great if it could be a CI job somewhere: do we have any existing scheduled jobs in EDK2 already, or is it something that would need to be added? Given that it was Stephano who originally said years ago that Doxygen generation should be in the cloud, and how nothing has changed since I'm skeptical about it, so for now I'll plan on setting up a scheduled job on my Gitlab instance (https://gitlab.bsdio.com) instead and continue publishing the pages on my site. But I'd be happy to help work towards putting it on tianocore.org as long as we don't lose any functionality in the process. -- Rebecca Cran On 11/9/21 7:27 PM, Michael D Kinney wrote: > Hi Rebecca, > > Yes. They are useful. I would be better if it could be a CI job on either Azure pipelines > or GitHub Actions could run the tool and publish the documents in TianoCore. Perhaps an on > demand job against a specific tag. > > Mike > >> -----Original Message----- >> From: devel@edk2.groups.io On Behalf Of Rebecca Cran >> Sent: Tuesday, November 9, 2021 3:20 PM >> To: devel@edk2.groups.io; discuss@edk2.groups.io >> Subject: [edk2-devel] EDK2 doxygen documentation - adding docs for stable tags? >> >> I've been hosting the Doxygen documentation for EDK2 at >> https://bsdio.com/edk2/docs for a few years now. I previously had >> versions for master, UDK2015, UDK2017, UDK2018 etc. but since migrating >> my web server dropped everything except master. >> >> >> I was wondering if people are finding it useful, and if so whether >> they'd like me to generate documentation for each stable tag too? >> >> >> Personally, _I_ find the web-based version (as opposed to a >> locally-generated version) useful for the search feature -- being able >> to quickly find the documentation for a certain function. >> >> >> -- >> >> Rebecca Cran >> >> >> >> >> >> > > > > >