You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@openjpa.apache.org by Dave Fisher <wa...@apache.org> on 2021/05/29 16:40:09 UTC
CMS Migration for OpenJPA
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
Re: CMS Migration for OpenJPA
Posted by Enrico Olivelli <eo...@gmail.com>.
Il Mar 29 Giu 2021, 17:16 Dave Fisher <wa...@apache.org> ha scritto:
> OpenJPA GitHub site is now in production!
>
Thank you very much!
Enrico
>
> Enjoy,
> Dave
>
> > On Jun 22, 2021, at 3:33 PM, Dave Fisher <wa...@apache.org> wrote:
> >
> > 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 <wa...@apache.org> 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 <rm...@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 <wa...@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 <wa...@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 <wa...@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
> >>>>>
> >>>>
> >>>>
> >>
> >
>
>
Re: CMS Migration for OpenJPA
Posted by Dave Fisher <wa...@apache.org>.
OpenJPA GitHub site is now in production!
Enjoy,
Dave
> On Jun 22, 2021, at 3:33 PM, Dave Fisher <wa...@apache.org> wrote:
>
> 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 <wa...@apache.org> 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 <rm...@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 <wa...@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 <wa...@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 <wa...@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
>>>>>
>>>>
>>>>
>>
>
Re: CMS Migration for OpenJPA
Posted by Dave Fisher <wa...@apache.org>.
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 <wa...@apache.org> 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 <rm...@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 <wa...@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 <wa...@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 <wa...@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
>>>>
>>>
>>>
>
Re: CMS Migration for OpenJPA
Posted by Dave Fisher <wa...@apache.org>.
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 <rm...@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 <wa...@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 <wa...@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 <wa...@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
>>>
>>
>>
Re: CMS Migration for OpenJPA
Posted by Romain Manni-Bucau <rm...@gmail.com>.
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 <wa...@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 <wa...@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 <wa...@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
> >
>
>
Re: CMS Migration for OpenJPA
Posted by Dave Fisher <wa...@apache.org>.
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 <wa...@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 <wa...@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
>
Re: CMS Migration for OpenJPA
Posted by Dave Fisher <wa...@apache.org>.
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 <wa...@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