[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[board-discuss] Apache ODF Toolkit migration




hello TDF folks,
hello ODF Toolkit community,

i'm writing here as a Committer (fwiw) of the Apache ODF Toolkit (incubating) project.

it turns out the ASF has voted to rename the Apache ODF Toolkit (incubating) project to Apache ODF Toolkit (retired).

https://lists.apache.org/thread.html/d4b4b33470a7bc3e70dc6192527168bb5907810045df5453c784cc93@%3Codf-dev.incubator.apache.org%3E

https://mail-archives.apache.org/mod_mbox/incubator-general/201811.mbox/%3cCA61FCD0-FF43-4E4A-BC30-5A942AE53B86@comcast.net%3e

the ODF Toolkit project is important for the ODF ecosystem in general and for LibreOffice in particular, since it contains not only the ODFDOM Java library, but also the most accurate ODF Validator, which we use in the LibreOffice test suite to check the ODF export filter.

so i'll propose to migrate the ODF Toolkit to The Document Foundation.

this is my (probably incomplete) understanding of the various different parts of the project that need some action:

1. git: the repository of record is on GitHub, and will be changed to
read-only by the ASF:

https://github.com/apache/odftoolkit

the obvious options are:
a) move the git repository to gerrit.libreoffice.org
b) fork the GitHub project and continue hosting on GitHub

In any case, we should have a redirect from the old incubator project
to the new sources (perhaps a big red notice in README will be
enough?).

2. the web site, in SVN (will also be changed to read-only):

https://svn.apache.org/repos/asf/incubator/odf/site/

the SVN repo contains some MarkDown files that are converted to
static HTML by some mysterious ASF-grown tool (Svante claims that
Perl scripts that rewrite references and a custom CMS are involved
somehow) that doesn't talk to anything other than the ASF SVN server
and which nobody in the ODF Toolkit project understands.

presumably there should be a way to preserve the (relatively small
and simple) content of the repo to either Wiki markup, or something
that some other MarkDown-to-HTML tool can understand; volunteers are
certainly welcome to help with this.

for a quick start it could also be an option to scrape the existing
HTML from http://incubator.apache.org/odftoolkit/ and replace the
internal URLs for consistency...

3. the domain "odftoolkit.org" - this currently redirects to
"http://incubator.apache.org/odftoolkit/";

this domain would need to be transferred from ASF to TDF before it
expires.

(i don't know whether other domains related to ODF Toolkit exist;
apparently "odftoolkit.com" was registered at some time but it's
already expired/for sale)

4. mailing list: the "odf-dev@incubator.apache.org" will be retired;
probably the amount of traffic is going to be quite small, hence
suggest to just use "libreoffice@freedesktop.org" for now; if the
traffic increases and becomes a problem a dedicated list can be
set up later.

5. currently the ASF JIRA is used as bug tracker, with project
"ODFTOOLKIT":


https://issues.apache.org/jira/browse/ODFTOOLKIT-479?jql=project%20%3D%20ODFTOOLKIT

there are currently 137 issues that are neither RESOLVED nor CLOSED.

so there are 2 decisions to be made here:

a) do we want a new component in "bugs.documentfoundation.org"
Bugzilla,
or use GitHub issues (only makes sense if GitHub is used for the
repo, of course)

b) should open issues be migrated? as long as they will be accessible
read-only in ASF JIRA (and i don't see any reason why not), i
don't see much value in it, since there aren't currently
developers available with time to fix the issues; if anybody feels
strongly about their issue they can re-create/copy it over
manually.

another point that we should probably discuss after the migration is finished is whether the so-called "Simple API" should be removed from ODFDOM due to being duplicative and unmaintained for years.

regards,
michael

PS: thanks to Svante for proofreading this, if any errors remain it's my fault

--
To unsubscribe e-mail to: board-discuss+unsubscribe@documentfoundation.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.documentfoundation.org/www/board-discuss/
Privacy Policy: https://www.documentfoundation.org/privacy

Follow-Ups:
[board-discuss] [VOTE] Host the ODF Toolkit project at TDFThorsten Behrens <thb@documentfoundation.org>
Re: [board-discuss] Apache ODF Toolkit migrationMichael Meeks <michael.meeks@collabora.com>
Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.