Developers of Sympa

[IKEDA Soji <address@concealed>]

Hi,

I created list of contents in old site, current www.sympa.org:

  https://gist.github.com/ikedas/2e6ef93856ec33ea388c6c7f8ea209aa [0]

Contents marked "×" have been moved to sympa-community.github.io
site.  Repo: https://github.com/sympa-community/sympa-community.github.io [1]

N.B.: Some of pages in manual were not moved, because they cannot be
confirmed permission by original authors.  We have to re-write
correspondent contents on new site (re-writing has partly done).


My comments on reports follows.


> ### Single entry point for Sympa

>  - Current www.sympa.org (a Dokuwiki-powered site) will be moved to
>    dokuwiki.sympa.org or archive.sympa.org domain for backup.
>  - 
> [sympa-community.github.io](https://github.com/sympa-community/sympa-community.github.io)
>  remains the central point for editing documentation.

  * Most of remainder of contents [2] in old site basically have only
    historic value, and proposal quoted above makes sense.

      * However, it means we have another abandoned farmland
        (following to demo.sympa.org, pootle.sympa.org, ...).  We'd
        be better to retrieve wiki data (content of data directory:
        cf. https://www.dokuwiki.org/devel:dirlayout) and to shut
        down it in near future, as soon as we can.

      * To avoid information loss, we'd be better to refrain from
        conversion as much as we can.

  * Logo data (see Logos/logos in link [0] above) would be moved to
    sympa-design repo https://github.com/sympa-community/sympa-design [3]
    so that they will be useful.

  * Developers' space would be on separate place.  I think GitHub wiki
    space is preferred: https://github.com/sympa-community/sympa/wiki [4]
    Because, in its nature, doc shared by developpers will tend to
    fluid and more or less inconsistent.

    N.B.: As many of contents on old site are such kind of things,
    they are not worth importing to new site, except as historical
    records.

>  - A new repository is created 
> ([dotorg](https://github.com/sympa-community/dotorg)) to handle:
>    - organisation of the Sympa project,
>    - an entry point for the community,
>    - links to release tarballs,
>    - contributing guidelines,
>    - events / news / announces.

  * Currently, information about authors, contribution, related projects
    etc. are put on top of sympa repo 
https://github.com/sympa-community/sympa [5]
      - AUTHORS.md : Authors
      - CONTRIBUTING.md : Contributing to Sympa
      - README.md : Projects related to Sympa

    As we'd be better to avoid redundant contents, these would be
    maintained instead of creating new content.

    N.B.: They also may be published as GitHub Pages.  See help:
    https://help.github.com/articles/user-organization-and-project-pages/

  * Recent articles of release announcement and source distribution
    are hosted by GitHub: https://github.com/sympa-community/sympa/releases 
[6]

    There is a problem that we cannot access to earlier distribution
    in consistent way (this matters on deployment with Ansible).
    Currently new releases are copied to /distribution/ directory manually.

    We have to find consistent way to avoid duplication.

Remainder of new site, i.e. contents except [1], [2], [3], [4], [5] and [6],
do not have their place.  After all, contents handled by new site
would be:

   - an entry point for the community
   - events / news

More essentially, we need at least a top page as entry point (list of
links to existing information described above) at first.

That's why we have to launch new site.

Am I right?


> The good point of this approach is to make web content independent
> from hosting. If the current hosting structure (RENATER) became
> deficient, community would still retain the data and would easily
> move to another hosting service.

This does not matter.  As we see, current contents have already
been independent from hosting.  Exception is a top page.


> Any concern related to Sympa web site - and tools - hosting should
> be discussed on a Github issue in the
> [web site project](https://github.com/sympa-community/dotorg/issues).

I see.  But before starting discussion, we'd be better to make
research on various services providing application and
infrastructure.


Regards,
-- Soji

-- 
株式会社 コンバージョン
ITソリューション部 システムソリューション1グループ 池田荘児
〒140-0014 東京都品川区大井1-49-15 アクセス大井町ビル4F
e-mail address@concealed  TEL 03-6429-2880
https://www.conversion.co.jp/