Poddling report draft - needs discussion

2017-04-02 Thread Daniel Dekany
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. 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.
  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 gene...@incubator.apache.org (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
  
https://cwiki.apache.org/confluence/display/FREEMARKER/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.

  We have added a How-To page for committers 
(http://freemarker.org/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


-- 
Thanks,
 Daniel Dekany



Re: Poddling report draft - needs discussion

2017-04-03 Thread Jacopo Cappellato
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 gene...@incubator.apache.org (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
>   https://cwiki.apache.org/confluence/display/FREEMARKER/
> 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
incubation"


>
>   We have added a How-To page for committers (http://freemarker.org/
> 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

Jacopo


>
>
> --
> Thanks,
>  Daniel Dekany
>
>