Aside from the apidocs in the build and docs directories the site is ready to 
go.

The README on https://github.com/apache/openjpa-site has a pointer to the Infra 
documentation and to migration notes which includes a diff on the markdown.

If the project wishes to help with the build and docs migration, the plan is to 
put the apidocs onto nightlies.apache.org. Let us know.

All the Best,
Dave


> On Jun 2, 2021, at 11:15 PM, Romain Manni-Bucau <rmannibu...@gmail.com> wrote:
> 
> Hi Dave,
> 
> Looks good to me - and to be honest looks better than what we had before in
> term of process ;).
> 
> Thanks a lot!
> 
> Romain Manni-Bucau
> @rmannibucau <https://twitter.com/rmannibucau> |  Blog
> <https://rmannibucau.metawerx.net/> | Old Blog
> <http://rmannibucau.wordpress.com> | Github <https://github.com/rmannibucau> |
> LinkedIn <https://www.linkedin.com/in/rmannibucau> | Book
> <https://www.packtpub.com/application-development/java-ee-8-high-performance>
> 
> 
> Le jeu. 3 juin 2021 à 00:18, Dave Fisher <w...@apache.org> a écrit :
> 
>> Hi -
>> 
>> Please find your staged migrated site at https://openjpa.staged.apache.org
>> 
>> The repository is at https://github.com/apache/openjpa-site
>> 
>> If you are an OpenJPA 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.
>> 
>> The 70K plus files in the builds and docs directories will remain in svn,
>> but in a new location. Lucene developed an approach in
>> https://issues.apache.org/jira/browse/INFRA-19439 which will be followed.
>> The builds and docs rewrites will work in production, but not on the
>> staging site.
>> 
>> I’ll be updating the README.md files in few days including notes on the
>> migration.
>> 
>> All The Best,
>> Dave
>> 
>>> On Jun 2, 2021, at 8:16 AM, Dave Fisher <w...@apache.org> wrote:
>>> 
>>> I’ll be working on this migration today.
>>> 
>>> The site has a mail folder that contains mailbox archives from 2005
>> through 2012. These archives are available from Infra at both
>> mail-archives.apache.org and lists.apache.org. These will not be migrated.
>>> 
>>> The builds (TLP releases) and docs (incubating releases) folders will be
>> migrated into the Git repository.
>>> 
>>> Regards,
>>> Dave
>>> 
>>>> On May 29, 2021, at 9:40 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 OpenJPA'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/ <https://github.com/apache/www-site/>
>>>> 
>>>> The following will occur.
>>>> - A new git repository is created. openjpa-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 openjpa.apache.org <http://openjpa.apache.org/>.
>>>> During the migration we will deploy to openjpa.staged.apache.org <
>> http://openjpa.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 openjpa-release.staged.apache.org <
>> http://openjpa-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 openjpa 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 openjpa-release.staged.apache.org <
>> http://openjpa-release.staged.apache.org/>
>>>> - Pull your changes from preview/release to main. openjpa.apache.org <
>> http://openjpa.apache.org/> is automatically updated.
>>>> 
>>>> All The Best,
>>>> Dave Fisher
>>> 
>> 
>> 

Reply via email to