Hi - The site is ready to go. https://gora.staged.apache.org
The README on https://github.com/apache/gora-site has a pointer to the Infra documentation and to migration notes which includes a diff on the markdown. I would like to make this migration live in 72 hours. All The Best, Dave > On Jun 3, 2021, at 12:30 PM, Dave Fisher <w...@apache.org> wrote: > > Hi - > > Please find your staged migrated site at https://gora.staged.apache.org > > The repository is at https://github.com/apache/gora-site > > If you are an Gora committer then you may need to go to > gitbox.apache.org/setup to connect your Apache ID to your GitHub ID. > > Any change that you commit in the repository will deploy within a few minutes > on staged. > > Most of the markdown files were edited to account for differences between > markdown.pl and the more strict GitHub Flavored Markdown (GFM) > > Space between ## and title. > Title metadata required. > Can’t mix in markdown in an html block. > > Note that the TOC rules differ. The Apache CMS takes every heading on the > page while the plugin here takes every heading after the TOC. I think this a > better experience. > > I’ll be updating the README.md files in few days including notes on the > migration. > > All The Best, > Dave > >> On May 29, 2021, at 9:34 AM, Dave Fisher <w...@apache.org> wrote: >> >> As you may recall the Apache CMS has been deprecated for over five years now >> and will be decommissioned >> by July 31, 2021. >> >> I’ve been tasked with moving Gora'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. >> - A new git repository is created. gora-site is preferred. >> - CMS mdtext files are converted to md and stored in the content tree. >> - Permalinks are created in the same manner. >> - Page templates will be converted essentially as is with some minor >> improvements. >> - Site data feeds are analyzed. If required a data model will be created. >> - HTML files (apidocs) built separately are copied into the content tree. >> I’ll make a judgement call on >> if these can be wrapped into the template. >> >> 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 gora.apache.org. >> During the migration we will deploy to gora.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 gora-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 gora 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 gora-release.staged.apache.org >> - Pull your changes from preview/release to main. gora.apache.org is >> automatically updated. >> >> All The Best, >> Dave Fisher >
