From dev-return-66302-archive-asf-public=cust-asf.ponee.io@flex.apache.org Wed Jun 9 18:31:21 2021 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mxout1-ec2-va.apache.org (mxout1-ec2-va.apache.org [3.227.148.255]) by mx-eu-01.ponee.io (Postfix) with ESMTPS id 7E2B918063F for ; Wed, 9 Jun 2021 20:31:21 +0200 (CEST) Received: from mail.apache.org (mailroute1-lw-us.apache.org [207.244.88.153]) by mxout1-ec2-va.apache.org (ASF Mail Server at mxout1-ec2-va.apache.org) with SMTP id A569D41E14 for ; Wed, 9 Jun 2021 18:31:20 +0000 (UTC) Received: (qmail 80621 invoked by uid 500); 9 Jun 2021 18:31:19 -0000 Mailing-List: contact dev-help@flex.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@flex.apache.org Delivered-To: mailing list dev@flex.apache.org Received: (qmail 80601 invoked by uid 99); 9 Jun 2021 18:31:19 -0000 Received: from mailrelay1-he-de.apache.org (HELO mailrelay1-he-de.apache.org) (116.203.21.61) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 09 Jun 2021 18:31:19 +0000 Received: from [IPv6:2601:649:280:9d60:20dd:90ec:7d8a:310b] (unknown [IPv6:2601:649:280:9d60:20dd:90ec:7d8a:310b]) by mailrelay1-he-de.apache.org (ASF Mail Server at mailrelay1-he-de.apache.org) with ESMTPSA id 5358F3E848; Wed, 9 Jun 2021 18:31:17 +0000 (UTC) From: Dave Fisher Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.4\)) Date: Wed, 9 Jun 2021 11:30:12 -0700 Subject: CMS Migration for Flex Message-Id: <0A67C1D6-4398-4A9E-961E-9DAB7D2635A6@apache.org> To: dev@flex.apache.org X-Mailer: Apple Mail (2.3608.120.23.2.4) As you may recall the Apache CMS has been deprecated for over five years = now and will be decommissioned by July 31, 2021. I=E2=80=99ve been tasked with moving OpenWebBeans's website away from = the Apache CMS. I will migrate your website to a Pelican build with GitHub Flavored = Markdown (GFM). For your reference the already migrated www-site is here = https://github.com/apache/www-site/ The following will occur. - flex-site git repository is already a mirror of the CMS content. = We=E2=80=99ll create a main branch. - CMS mdtext and Cmspage files are converted to md and stored in the = content tree. - Page templates will be converted essentially as is with some minor = improvements. - HTML files (apidocs) built separately are copied into the content = tree.=20 The Apache CMS had a cumbersome process of individual checkouts -> = staging -> publishing. The new branching strategy is as follows: - main will have the site content sources and any additional docs (like = api docs). - asf-site will have the production website which is automatically = deployed to flex.apache.org. During the migration we will deploy to flex.staged.apache.org - preview/release will have the website prepared for the next release. = You will add release specific docs to this branch - preview/release-staging will have the built preview website which is = automatically deployed to flex-release.staged.apache.org This new plan allows for a redesign of your site without danger of = premature deployment. If you decide that GFM is not for flex then you can switch to a = different process within a preview branch. Release steps for the website could be: - Branch main as preview/release - Make your updates to preview/release - Confirm your changes on flex-release.staged.apache.org - Pull your changes from preview/release to main. flex.apache.org is = automatically updated. All The Best, Dave Fisher=