freemarker-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jacopo Cappellato <>
Subject Re: Poddling report draft - needs discussion
Date Mon, 03 Apr 2017 08:02:59 GMT
The reports looks great to me but see some minor comments inline:

On Sun, Apr 2, 2017 at 12:35 PM, Daniel Dekany <> wrote:

> See below. It's more "interesting" than usual (graduation issues...),
> so we should definitely discuss this before I upload it.
> FreeMarker
> FreeMarker is a template engine, i.e. a generic tool to generate text
> output based on templates. FreeMarker is implemented in Java as a
> class library for programmers.
> FreeMarker has been incubating since 2015-07-01.
> Three most important issues to address in the move towards graduation:
>   The project is still struggling to find a way to "convert" active
>   users into committers.

I would change the the above sentence to convey a more positive message:

"The project is constantly exploring new ways to "convert" active users
into committers, since we have a very large user base and a rather small
group of committers."

>  This was actually expected, given the age

  (and topic) of the project.

While the FreeMarker 3 line, which was
>   started quite recently, will be much more appealing for
>   contributors, development on that direction will certainly take a
>   long time. In other respects the project is mature and ready for
>   graduation.
> Any issues that the Incubator PMC (IPMC) or ASF Board wish/need to be
> aware of?
>   We are eager to graduate, but we don't think that the problem with
>   the number of active contributors will be solved in the near future.

As you know, in my opinion FreeMarker is ready to become a TLP; with this
said, personally
I would change the above sentence into:

"We are eager to graduate but we were hoping to increase the number of
active contributors more before the graduation. However, since the
community is slowly growing and we have completed all the Incubation tasks,
we are now more inclined to discuss the graduation now and then proceed as
a top level project."

>   One of the practical problems with being stuck in the Incubator is
>   that many users stick to the last non-incubating release as that has
>   no "-incubating" in the Maven coordinates, missing out on fixes and
>   features done in the recent two years. We brought up the issue with
>   the Maven coordinate on (saying that
>   because our Maven coordinate doesn't contain "apache", "incubating"
>   is meaningless in there), but there was no consensus.
> How has the community developed since the last report?
>   We have welcomed a new committer, Woonsan Ko.
>   A few new people has shown up to help out with our Twitter channel
>   (such as making a new logo for it, and helping to make it more
>   active), and to work modernizing our build scripts.
>   The starting of the FreeMarker 3 branch has generated some technical
>   discussion.
> How has the project developed since the last report?
>   We have created a Project Maturity Model page at
> Apache+Freemarker+Project+Maturity+Model
>   We have started the FreeMarker 3 branch, whose goal is to get rid of
>   backward compatibility burden that holds back the project quite much
>   at this point, and doesn't allow us to fully capitalize on the
>   experiences of the last 15 years. In out current situation it's also
>   very important that then new branch, as it advances, will be
>   technically far more appealing than the legacy branch for
>   contributors. Also, the new branch uses org.apache packages and
>   Maven coordinates (which FreeMarker 2 can't do).
>   We have received a bigger contribution from Kenshoo, the source code
>   of an online template evaluator service, which we plan to use on our
>   home page, helping users to try and learn the template language.
>   We have released a new micro version (2.3.26), focuses on fixes and
> smaller improvements.

I would add:

"This is the third (is it right? please check) release issued during the

>   We have added a How-To page for committers (
> committer-howto.html),
>   which gives detailed instructions on making releases, handling pull
> requests,
>   updating the project home page, and more.
>   We have worked some on our Twitter channel, such as we have a new
>   logo and some posts.
> When were the last committers or PMC members elected?
>   2017-02-13 Woonsan Ko, committer (non-PMC)
> Date of last release:
>   2017-03-25
> Signed-off-by:
>   [ ](freemarker) Jacopo Cappellato
>   [ ](freemarker) Jean-Frederic Clere
>   [ ](freemarker) David E. Jones
>   [ ](freemarker) Ralph Goers
>   [ ](freemarker) Sergio Fernández

I like it! Thanks


> --
> Thanks,
>  Daniel Dekany

  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message