The Migration from CMS to ASF-Pelican is staged!

https://openjpa.staged.apache.org/ is ready.

https://github.com/apache/openjpa-site/

For information about ASF-Pelican: https://infra.apache.org/asf-pelican.html

Please note that documentation.html has been changed to point to staged copies 
of the documentation.

The builds and docs branches in the openjpa-site repository now contain the 
apidocs.

Assuming all is good I will move this to production this coming weekend.

All The Best,
Dave

> On Jun 13, 2021, at 3:59 PM, Dave Fisher <[email protected]> wrote:
> 
> 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 <[email protected]> 
>> 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 <[email protected]> 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 <[email protected]> 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 <[email protected]> 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