You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@sis.apache.org by Andrew Wetmore <an...@apache.org> on 2021/02/03 13:39:08 UTC

Re: Your project's website

Hi, all, and happy New Year!

Is there any news on the migration of your project website off the CMS? Any
information Infra can provide?

Andrew

On Mon, Aug 10, 2020 at 10:42 AM Andrew Wetmore <an...@apache.org> wrote:

> Hi!
>
> Yes, it sounds like the migration will be less complex than what some
> projects are facing.
>
> The next steps would be for the PMC to agree on what technology to move
> the site to. A lot of projects use Pelican or Hugo, but there are many
> other static-site generators available. You can also open a Jira ticket for
> INFRA to cover the work involved in this move. That way the Infra team can
> be ready to help.
>
> Andrew
>
>
> <https://www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail> Virus-free.
> www.avast.com
> <https://www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail>
> <#m_8806678561665827348_DAB4FAD8-2DD7-40BB-A1B8-4E2AA1F9FDF2>
>
> On Mon, Aug 10, 2020 at 5:58 AM Martin Desruisseaux <
> desruisseaux@apache.org> wrote:
>
>> Hello Andrew
>>
>> Thanks for the notification. Apache SIS uses CMS in the following ways:
>>
>>    - We commit content to
>>    https://svn.apache.org/repos/asf/sis/site/trunk/
>>    - When ready we go on https://cms.apache.org/sis/ and click "Publish
>>    sis site".
>>
>> The site repository on SVN has only the trunk, no branch. The content is
>> fully static, with two kinds of files:
>>
>>    - *.mdtext converted to HTML using templates.
>>    - Pure HTML (mostly javadoc) to be copied as-is.
>>
>> I can be the project point-of-contact (unless another volunteer wants to
>> be involved). I'm not familiar with alternatives, but given that SIS site
>> uses nothing sophisticated I presume that with a little bit of guidance,
>> the migration should be relatively easy.
>>
>>     Thanks,
>>
>>         Martin
>>
>>
>> Le 07/08/2020 à 14:56, Andrew Wetmore a écrit :
>>
>> I am part of the Infrastructure team, and am writing to ask whether your
>> project is still using the Apache CMS for your project website. As you
>> know, the CMS is reaching end-of-life, and we need projects to move their
>> websites onto a different option within the next few weeks.
>>
>> There are several alternatives available, including those listed on this
>> page [1] on managing project websites. Infra is assembling a Wiki page [2]
>> on migrating a website from the CMS, and is looking forward to helping
>> projects with this transition.
>>
>> Please let me know whether your site is still on the Apache CMS and, if so,
>> who will be the project point-of-contact with Infra for the migration.
>>
>> Thank you!
>>
>>
>>
>
> --
> Andrew Wetmore
> Technical Writer-Editor
> Infra
> *Apache Software Foundation*
> andreww@apache.org
>


-- 
Andrew Wetmore
Technical Writer-Editor
Infra
*Apache Software Foundation*
andreww@apache.org

Re: Your project's website

Posted by Martin Desruisseaux <ma...@geomatys.com>.
Hello Andrew

We have a prototype of Apache SIS source files migrated to Hugo system 
[1]. Before to create a task on INFRA, I would like to verify if I'm 
understanding the steps correctly:

  * We would create a new Git repository on [2] named "sis-site". Is
    that right?
  * That repository would contain the following branches, is that right?
      o master or main or trunk: the markdown source files.
      o asf-staging: HTML files generated by Hugo from the sources, to
        be published in preview domain.
      o asf-site: files published in production domain. I presume this
        branch is updated by marging asf-staging into asf-site.
      o javadoc: static HTML files generated by javadoc.

Above cited branches would be published in following domains, is that right?

  * asf-staging: http://sis.staging.apache.org/
  * asf-site: http://sis.apache.org/
  * javadoc: http://sis.apache.org/apidocs/index.html

What happen to the following repositories?

  * https://svn.apache.org/repos/asf/sis/site/trunk/
  * https://svn.apache.org/repos/infra/websites/staging/sis/trunk/content/
  * https://svn.apache.org/repos/infra/websites/production/sis/content/

We do not plan to use Jenkins at this time. Hugo would be executed 
manually on the developer machine for medium terms.

Is there anything above which is incorrect?

     Thanks,

         Martin

[1] https://github.com/kinow/sis-site-draft
[2] https://gitbox.apache.org/setup/newrepo.html


Re: Your project's website

Posted by Andrew Wetmore <an...@apache.org>.
Hi!

You sound very busy.

Yes, if the CMS were to stop functioning right now, the static websites for
each project would remain in place. It would just be harder to edit them
and MUCH harder to update the site, as a migration to a new tech would
have to happen first.

Let us know if there is any info we can provide that would help you. We
can, for instance, point you to other projects using the various tech
options we have recommended, if you want to use them as a template or
consult with them about their experience.

Andrew.

On Wed, Feb 3, 2021 at 10:01 AM Martin Desruisseaux <
martin.desruisseaux@geomatys.com> wrote:

> Hello Andrew
>
> Thans for following up!
>
> Le 03/02/2021 à 14:39, Andrew Wetmore a écrit :
>
> Is there any news on the migration of your project website off the CMS?
> Any information Infra can provide?
>
> We did not yet started the migration. I realize that the old CMS will be
> offline soon, but if I understood correctly, the currently existing static
> pages would not be impacted; we would "only" be unable to update the web
> site until we do the migration, is that right?
>
> The main blocking issue is that, on my side, I'm unfamiliar with all
> alternatives. My plan was to finish the development work on branch for
> merging on "master" so we can start thinking about a release, and do the
> CMS migration during the time that peoples evaluate what is on "master".
> But it is taking me a loooong time.
>
> Alternatively we are preparing a code sprint (a joint event between ASF
> and 2 other organizations) for February 17 to 19 and I submitted SIS web
> site migration as a task [1], but I do not know if any volunteer will
> pickup this task.
>
> Is the assumption in the first paragraph true?
>
>     Martin
>
> [1] https://github.com/opengeospatial/joint-ogc-osgeo-asf-sprint-2021/issues/2#issuecomment-769866400
>
>

-- 
Andrew Wetmore
Technical Writer-Editor
Infra
*Apache Software Foundation*
andreww@apache.org

Re: Your project's website

Posted by Martin Desruisseaux <ma...@geomatys.com>.
Hello Andrew

Thans for following up!

Le 03/02/2021 à 14:39, Andrew Wetmore a écrit :

> Is there any news on the migration of your project website off the 
> CMS? Any information Infra can provide?
>
We did not yet started the migration. I realize that the old CMS will be 
offline soon, but if I understood correctly, the currently existing 
static pages would not be impacted; we would "only" be unable to update 
the web site until we do the migration, is that right?

The main blocking issue is that, on my side, I'm unfamiliar with all 
alternatives. My plan was to finish the development work on branch for 
merging on "master" so we can start thinking about a release, and do the 
CMS migration during the time that peoples evaluate what is on "master". 
But it is taking me a loooong time.

Alternatively we are preparing a code sprint (a joint event between ASF 
and 2 other organizations) for February 17 to 19 and I submitted SIS web 
site migration as a task [1], but I do not know if any volunteer will 
pickup this task.

Is the assumption in the first paragraph true?

     Martin

[1] https://github.com/opengeospatial/joint-ogc-osgeo-asf-sprint-2021/issues/2#issuecomment-769866400