date:20170107

2017-01-07 22:56 GMT+01:00 Daniel Dekany :

> I have changed the subject so that we don't pollute the social media
> thread... See my comments below.
>
>
> Saturday, January 7, 2017, 9:01:06 PM, Christoph Rüger wrote:
> [snip]
> >> For example, apparently, you have hard time
> >> dealing with null-s in your application (lot of `exp!`-s everywhere),
> >> so you may want to chime in when the null/missing handling
> >> improvements in FM3 are discussed.
> >>
> > Yeah we just decided to put ! by default everywhere. In our uses cases in
> > 99% this is ok, as it should just render an empty String when something
> is
> > null.
>
> The reason we are picky about null-s is to catch typos. It's a partial
> solution as if you have values which can be legally null, you have to
> add some `!`, and then any typo you make will be hidden... but we
> couldn't do better if we assume that the data-model is some kind of
> Map.
>

Yes, I know. I think the strict null handling is ok. I also like it to spot
typos.
To make it short: I guess it is a bit of legacy on our end that we've
suggested the customer to put it.


>
> If you put `!` almost everywhere, then the way null is treated by FM
> is just a burden without the benefits. Can't you tell on that platform
> what the accepted variable *names* are? Because then you could default
> the valid ones to general-purpose-nothing (the result of null!) on the
> data-model level, and let the others be null and explode, because they
> are typos.
>
> BTW if I write ${nosuchthing}, it just prints nothing... So I do not
> need the `!` apparently.
>

I guess we are already experimenting with a wrapper underneath. I don't
know all the code anymore ;) But remember there are cases (maybe in other
parts... Transformy is just one part. we also use FM to write
filter-conditions for something we call SpreadsheetFilter...which you
cannot see in Transformy. maybe it was needed there because things can
become null... don't know).

I guess that is our part of the homework to figure out better
pre-processing here.



>
> >> BTW I see some examples like ${datecalc("HOUR", 1)!?datetime}. I guess
> >> you can't possibly get a null there. Even if you do, ?datetime will be
> >> unhappy with the '' it had to convert to date-time, unless you have a
> >> custom data-time format there.
> >>
> > Your are probably right. in this case the ! is not needed and we could
> > avoid it. Can't remember why we've put it... maybe just to make it look
> > consistent to our customers and to avoid questions ;)
> >
> >
> >>
> >> > (it"s german...just use google translator) where we show how to do
> >> > various stuff with Freemarker expressions. We have also written some
> >> > own functions (here) which could also be useful maybe as core
> >> > built-ins (see here)
> >>
> >> Some questions/notes...
> >>
> >> How does `escapeHTML(exp)` differ from `exp?html`?
> >>
> > our escapeHTML uses
> > https://commons.apache.org/proper/commons-lang/javadocs/
> api-2.6/org/apache/commons/lang/StringEscapeUtils.html#
> escapeHtml(java.lang.String)
> > under
> > the hood.
>
> Maybe because StringEscapeUtils.escapeHtml(String) escapes accented
> letters. Though nowadays that's not needed... you just set the
> response charset to UTF-8, and all funny characters come through.
>

Ok good to know.

>
> >> What's the practical use of `unescapeHTML(exp)`?
> >>
> > the opposite of escapeHTML  using
> > https://commons.apache.org/proper/commons-lang/javadocs/
> api-2.6/org/apache/commons/lang/StringEscapeUtils.html#
> unescapeHtml(java.lang.String)
> >
> > I can't remember but I think we had a case where we needed exactly the
> > escaping of Apache StringUtils and maybe it was different than what
> > Freemarker does? not sure...
>
> FreeMarker doesn't have unescape functionality at all. The question
> is, why do you need to unescape in a template?
>

Not sure anymore, but I guess assume the following:
A 3rd party supplier of our customer sends a CSV containing escaped
HTML-code (with all the < etc.). But the customer wants to  convert it
back to > because that is how he needs it in his output data (e.g. for
importing somewhere else). Most of the time our customers need to deal with
data which is a mess (like you said with Excel), but we cannot change it.
And we provide FM as the tool to move this data around until it fits your
needs. It does the job so far.


>
> >> Also note that there's the auto-escaping machinery (output formats,
> >> ?esc, etc.) nowadays. It tries to removing the responsibility of
> >> escaping from the template author (without using #escape, which itself
> >> can be forgotten, or had to be added with TemplateLoader hacks). You
> >> can have HTML fragments in the data-model that are automatically *not*
> >> escaped, and everything else is automatically escaped. But even if
> >> your data-model can't be made that smart (i.e. HTML is also Space), at
> >> least you escape be default (and the you can do exp?noEsc to prevent
> >> it

Re: FreeMarker Project Maturity Model Assessment

2017-01-07 Thread Jacques Le Roux

The Confluence version at the ASF works well now. It's a reliable WYSIWG
version.

One of the big advantages of Confluence is it allows finely grained
permissions. This is not only useful with spam.

Another advantage is it has, even at the ASF, a lot of available plugins

This said it can be sometimes a bit slow, and creating long complicated page can turn to a be nightmare especially if you put a lot of images. At
least now you never lose anything, it has a very good automated versionning system...

Jacques

PS: I don't think anybody is a Confluence huge fan ;)
https://lists.apache.org/thread.html/1adaf03b52c34de6a3502a9bab2f8c27548071d2105aeac41f11ccf4@1432806673@%3Cuser.ofbiz.apache.org%3E

Le 07/01/2017 à 20:36, Daniel Dekany a écrit :

Does Confluence work well for developer topics though? Because I guess
we will want to use it for FM3. I had to use it on workplace, a
relatively old version, and it was a nightmare because it gets
confused by the odd stuff we programmers write... and yes, there are
some escaping rules and all, but over all it wasn't practical to use,
plus it was buggy... though yet again maybe nowadays it's better.

Saturday, January 7, 2017, 7:17:07 PM, Jacques Le Roux wrote:

I'd prefer Confluence as we have experience with it in the OFBiz team

My 2cts

Jacques

Le 07/01/2017 à 18:49, Jacopo Cappellato a écrit :

On Sat, Jan 7, 2017 at 6:47 PM, Daniel Dekany wrote:

We have never requested a wiki from infra... so I as far as know we
don't have it yet.

Should we request one? It can be useful to work together on a shared
document like in this case. Suggestions/proposals/preferences?

Jacopo

Thoughts on using FM with Transformy (Was: Using Social Media to Help Promote Freemarker)

I have changed the subject so that we don't pollute the social media
thread... See my comments below.


Saturday, January 7, 2017, 9:01:06 PM, Christoph Rüger wrote:
[snip]
>> For example, apparently, you have hard time
>> dealing with null-s in your application (lot of `exp!`-s everywhere),
>> so you may want to chime in when the null/missing handling
>> improvements in FM3 are discussed.
>>
> Yeah we just decided to put ! by default everywhere. In our uses cases in
> 99% this is ok, as it should just render an empty String when something is
> null.

The reason we are picky about null-s is to catch typos. It's a partial
solution as if you have values which can be legally null, you have to
add some `!`, and then any typo you make will be hidden... but we
couldn't do better if we assume that the data-model is some kind of
Map.

If you put `!` almost everywhere, then the way null is treated by FM
is just a burden without the benefits. Can't you tell on that platform
what the accepted variable *names* are? Because then you could default
the valid ones to general-purpose-nothing (the result of null!) on the
data-model level, and let the others be null and explode, because they
are typos.

BTW if I write ${nosuchthing}, it just prints nothing... So I do not
need the `!` apparently.

>> BTW I see some examples like ${datecalc("HOUR", 1)!?datetime}. I guess
>> you can't possibly get a null there. Even if you do, ?datetime will be
>> unhappy with the '' it had to convert to date-time, unless you have a
>> custom data-time format there.
>>
> Your are probably right. in this case the ! is not needed and we could
> avoid it. Can't remember why we've put it... maybe just to make it look
> consistent to our customers and to avoid questions ;)
>
>
>>
>> > (it"s german...just use google translator) where we show how to do
>> > various stuff with Freemarker expressions. We have also written some
>> > own functions (here) which could also be useful maybe as core
>> > built-ins (see here)
>>
>> Some questions/notes...
>>
>> How does `escapeHTML(exp)` differ from `exp?html`?
>>
> our escapeHTML uses
> https://commons.apache.org/proper/commons-lang/javadocs/api-2.6/org/apache/commons/lang/StringEscapeUtils.html#escapeHtml(java.lang.String)
> under
> the hood.

Maybe because StringEscapeUtils.escapeHtml(String) escapes accented
letters. Though nowadays that's not needed... you just set the
response charset to UTF-8, and all funny characters come through.

>> What's the practical use of `unescapeHTML(exp)`?
>>
> the opposite of escapeHTML  using
> https://commons.apache.org/proper/commons-lang/javadocs/api-2.6/org/apache/commons/lang/StringEscapeUtils.html#unescapeHtml(java.lang.String)
>
> I can't remember but I think we had a case where we needed exactly the
> escaping of Apache StringUtils and maybe it was different than what
> Freemarker does? not sure...

FreeMarker doesn't have unescape functionality at all. The question
is, why do you need to unescape in a template?

>> Also note that there's the auto-escaping machinery (output formats,
>> ?esc, etc.) nowadays. It tries to removing the responsibility of
>> escaping from the template author (without using #escape, which itself
>> can be forgotten, or had to be added with TemplateLoader hacks). You
>> can have HTML fragments in the data-model that are automatically *not*
>> escaped, and everything else is automatically escaped. But even if
>> your data-model can't be made that smart (i.e. HTML is also Space), at
>> least you escape be default (and the you can do exp?noEsc to prevent
>> it), which is safer than the opposite.
>>
> Yes, we want to try that out too, but many of our custom functions were
> created a long time ago. We currently have a strong focus on ecommerce and
> onlinemarketing, so the use-cases which drove those functions where coming
> from such projects.

As far as those are #function-s or TemplateMethodModel-s, I don't
think that it interferes with them. The values of those has to be
escaped, I suppose. (Even if there are legacy macros, you can
configure FreeMarker to not use auto-escaping for the templates the
define the macros, and they remain callable from auto-escaping
templates without problem.)

>> As of `now()`, we have `.now`, though that returns a java.util.Date
>> instead of a long. So the equivalent is `.now?long`, which is somewhat
>> ugly. Note sure why and how often do you need the numerical version
>> though.
>>
> We provide both to the users in some kind of context-menu. Maybe at the
> time we wanted something as short but with the numerical version.
>
>
>> > Just let me know if this is interesting, so we can think about
>> > concrete stuff we could contribute where it fits.
>>
>> Calendar arithmetic is something users often request (i.e., adding a
>> day, truncating the date down to the beginning of the month/day/hour
>> and such). Anyway, if you have some concrete recommendation for
>> built-ins, tell us.
>>
> Yes calendar arithmetic is

Re: Using Social Media to Help Promote Freemarker

On more thing... the hard part in an evaluator tool is defining the
data-model. On freemarker-online that's a very limited due to security
reasons. In a tool that the user runs on his on computer though, it's
not a problem to allow defining values in Groovy for example.


Saturday, January 7, 2017, 6:45:10 PM, Daniel Dekany wrote:

> Saturday, January 7, 2017, 4:37:12 PM, Denis Bredelet wrote:
>
> [snip]
>>> These are some getting started examples. What are your ideas about the
>>> final product?
>>
>> I am thinking of adding a « main » function in the FreeMarker JAR
>> to load a template and a model (as XML or properties, that is why I
>> showed the link). Then create a separate JAR with the UI to load the
>> template and datamodel from the filesystem or define a datamodel
>> interactively, and save the processed template in a file.
>
> The whole functionality, even if it's only a console app with a main
> method, should be in a separate jar, and certainly even in a separate
> project (like we have freemarker-site, freemarker-docgen, and then we
> could have freemarker-tester or something). Since dependency
> management has become common place, it's considered to be a bad
> practice to overpack your jar-s. In fact, something that we consider
> to do in FM3 is exploding freemarker.jar into submodules (like
> freemarker-servet.jar, etc.). Back then it was more practical to make
> a big monolithic jar, but times are changing.
>
> Also, a separate project (again, still under the umbrella of
> FreeMarker and Apache) means that you can do releases independently of
> the FreeMarker (the engine) project releases.
>
> Also note that "main" methods in a library are seen as security
> problems nowadays. We already have a bunch of them in freemarker.jar,
> and I'm just waiting for the right moment to get rid of them.
>
> So, yeah, I say, separate jar, separate project.
>

-- 
Thanks,
 Daniel Dekany

Re: FreeMarker Project Maturity Model Assessment

2017-01-07 Thread Michael Brohl

I suggest to use a tool we have easy access to, which provides enough 
functionality to collaborate and can "grow" with the requirements. It think 
Confluence will fit these requirements (I'm not a big fan either).

Regards,
Michael


> Am 07.01.2017 um 21:10 schrieb Christoph Rüger :
> 
> What I am talking about at github is the wiki. But it needs to be enabled 
> first in the settings.. 
> 
> 
> Regarding confluence: 
> We use it too, and the one thing I really like about it , is the ability to 
> paste images from the clip board and they are automatically uploaded. but we 
> use screenshots a lot. Not sure this is a requirement for FM. 
> But on the other hand confluence is a huge tool which may be more that what 
> is needed here. 
> Just my 2 cents.
> 
> 
> 2017-01-07 21:02 GMT+01:00 Jacopo Cappellato :
>> On Sat, Jan 7, 2017 at 8:36 PM, Daniel Dekany  wrote:
>> 
>> > Does Confluence work well for developer topics though? Because I guess
>> > we will want to use it for FM3. I had to use it on workplace, a
>> > relatively old version, and it was a nightmare because it gets
>> > confused by the odd stuff we programmers write... and yes, there are
>> > some escaping rules and all, but over all it wasn't practical to use,
>> > plus it was buggy... though yet again maybe nowadays it's better.
>> >
>> >
>> I am not an expert, nor a huge fan of Confluence, but maybe for our simple
>> requirement we could live with any Wiki tool that the ASF Infra can provide
>> or , as suggested by Christoph, with a page in git. My only concern with
>> Git is that it may make the workflow a bit complicated.
>> 
>> Jacopo
> 
> 
> 
> -- 
> Christoph Rüger, Geschäftsführer
> Synesty - Automatisierung, Schnittstellen, Datenfeeds
> Tel.: +49 3641/559649
> 
> Xing: https://www.xing.com/profile/Christoph_Rueger2
> LinkedIn: http://www.linkedin.com/pub/christoph-rueger/a/685/198
> 
> Synesty GmbH
> Moritz-von-Rohr-Str. 1a
> 07745 Jena
> Tel.: +49 3641 559649
> Fax.: +49 3641 5596499
> Internet: http://synesty.com
> 
> Geschäftsführer: Christoph Rüger
> Unternehmenssitz: Jena
> Handelsregister B beim Amtsgericht: Jena
> Handelsregister-Nummer: HRB 508766
> Ust-IdNr.: DE287564982


smime.p7s
Description: S/MIME cryptographic signature

Re: FreeMarker Project Maturity Model Assessment

What I am talking about at github is the wiki. But it needs to be enabled
first in the settings..
[image: Inline-Bild 2]

Regarding confluence:
We use it too, and the one thing I really like about it , is the ability to
paste images from the clip board and they are automatically uploaded. but
we use screenshots a lot. Not sure this is a requirement for FM.
But on the other hand confluence is a huge tool which may be more that what
is needed here.
Just my 2 cents.


2017-01-07 21:02 GMT+01:00 Jacopo Cappellato :

> On Sat, Jan 7, 2017 at 8:36 PM, Daniel Dekany  wrote:
>
> > Does Confluence work well for developer topics though? Because I guess
> > we will want to use it for FM3. I had to use it on workplace, a
> > relatively old version, and it was a nightmare because it gets
> > confused by the odd stuff we programmers write... and yes, there are
> > some escaping rules and all, but over all it wasn't practical to use,
> > plus it was buggy... though yet again maybe nowadays it's better.
> >
> >
> I am not an expert, nor a huge fan of Confluence, but maybe for our simple
> requirement we could live with any Wiki tool that the ASF Infra can provide
> or , as suggested by Christoph, with a page in git. My only concern with
> Git is that it may make the workflow a bit complicated.
>
> Jacopo
>



-- 
Christoph Rüger, Geschäftsführer
Synesty  - Automatisierung, Schnittstellen, Datenfeeds
Tel.: +49 3641/559649

Xing: https://www.xing.com/profile/Christoph_Rueger2
LinkedIn: http://www.linkedin.com/pub/christoph-rueger/a/685/198

-- 
Synesty GmbH
Moritz-von-Rohr-Str. 1a
07745 Jena
Tel.: +49 3641 559649
Fax.: +49 3641 5596499
Internet: http://synesty.com

Geschäftsführer: Christoph Rüger
Unternehmenssitz: Jena
Handelsregister B beim Amtsgericht: Jena
Handelsregister-Nummer: HRB 508766
Ust-IdNr.: DE287564982

Re: FreeMarker Project Maturity Model Assessment

On Sat, Jan 7, 2017 at 8:36 PM, Daniel Dekany  wrote:

> Does Confluence work well for developer topics though? Because I guess
> we will want to use it for FM3. I had to use it on workplace, a
> relatively old version, and it was a nightmare because it gets
> confused by the odd stuff we programmers write... and yes, there are
> some escaping rules and all, but over all it wasn't practical to use,
> plus it was buggy... though yet again maybe nowadays it's better.
>
>
I am not an expert, nor a huge fan of Confluence, but maybe for our simple
requirement we could live with any Wiki tool that the ASF Infra can provide
or , as suggested by Christoph, with a page in git. My only concern with
Git is that it may make the workflow a bit complicated.

Jacopo

Re: Using Social Media to Help Promote Freemarker

Hi Daniel,


2017-01-07 17:19 GMT+01:00 Daniel Dekany :

> Saturday, January 7, 2017, 2:38:16 PM, Christoph Rüger wrote:
>
> > regarding promoting freemarker:
> > We are already doing that  in our Cloud-Data-platform where you can
> > use freemarker to do almost anything to transform, map and manipulate
> data.
> > We use it for our own application too (all templates) but we also
> > have chosen Freemarker as the main internal scripting language for data
> transformation.
> >
> > Here is a small example which just concatenates two variables in
> > the column "newtitle". Check it out if you want. It goes in a
> > similar direction as  http://freemarker-online.kenshoo.com/
> >
> > That being said I think we are also happy to contribute interesting
> > usecases, examples and whatever which could be spread using
> > SocialMedia. We have lots of examples in our own documentation
> > (here)
>
> I would only answer to this as technical guy.
>
> Your use cases are interesting in that you want not-so-technical
> people to write templates.

Exactly. Our customers are usually Excel-savvy but no programmers.


> For example, apparently, you have hard time
> dealing with null-s in your application (lot of `exp!`-s everywhere),
> so you may want to chime in when the null/missing handling
> improvements in FM3 are discussed.
>
Yeah we just decided to put ! by default everywhere. In our uses cases in
99% this is ok, as it should just render an empty String when something is
null.


>
> BTW I see some examples like ${datecalc("HOUR", 1)!?datetime}. I guess
> you can't possibly get a null there. Even if you do, ?datetime will be
> unhappy with the '' it had to convert to date-time, unless you have a
> custom data-time format there.
>
Your are probably right. in this case the ! is not needed and we could
avoid it. Can't remember why we've put it... maybe just to make it look
consistent to our customers and to avoid questions ;)


>
> > (it"s german...just use google translator) where we show how to do
> > various stuff with Freemarker expressions. We have also written some
> > own functions (here) which could also be useful maybe as core
> > built-ins (see here)
>
> Some questions/notes...
>
> How does `escapeHTML(exp)` differ from `exp?html`?
>
our escapeHTML uses
https://commons.apache.org/proper/commons-lang/javadocs/api-2.6/org/apache/commons/lang/StringEscapeUtils.html#escapeHtml(java.lang.String)
under
the hood.

>
> What's the practical use of `unescapeHTML(exp)`?
>
the opposite of escapeHTML  using
https://commons.apache.org/proper/commons-lang/javadocs/api-2.6/org/apache/commons/lang/StringEscapeUtils.html#unescapeHtml(java.lang.String)

I can't remember but I think we had a case where we needed exactly the
escaping of Apache StringUtils and maybe it was different than what
Freemarker does? not sure...

>
> Also note that there's the auto-escaping machinery (output formats,
> ?esc, etc.) nowadays. It tries to removing the responsibility of
> escaping from the template author (without using #escape, which itself
> can be forgotten, or had to be added with TemplateLoader hacks). You
> can have HTML fragments in the data-model that are automatically *not*
> escaped, and everything else is automatically escaped. But even if
> your data-model can't be made that smart (i.e. HTML is also Space), at
> least you escape be default (and the you can do exp?noEsc to prevent
> it), which is safer than the opposite.
>
Yes, we want to try that out too, but many of our custom functions were
created a long time ago. We currently have a strong focus on ecommerce and
onlinemarketing, so the use-cases which drove those functions where coming
from such projects.



>
> As of `now()`, we have `.now`, though that returns a java.util.Date
> instead of a long. So the equivalent is `.now?long`, which is somewhat
> ugly. Note sure why and how often do you need the numerical version
> though.
>
We provide both to the users in some kind of context-menu. Maybe at the
time we wanted something as short but with the numerical version.


> > Just let me know if this is interesting, so we can think about
> > concrete stuff we could contribute where it fits.
>
> Calendar arithmetic is something users often request (i.e., adding a
> day, truncating the date down to the beginning of the month/day/hour
> and such). Anyway, if you have some concrete recommendation for
> built-ins, tell us.
>
Yes calendar arithmetic is a big one. we already have a dateCalc() function
and first/lastDayOfMonth() (which we will probably make more generic into
something like firstDayOf("year",mydate) or so.
Customers need this often to create date-ranges e.g. to make API-calls to a
REST-API (e.g. "give me all orders from last month")


> I'm interested to hear what your major pain points with FM are. A
> single template engine can't be ideal for everyone, but I'm hoping to
> cover more kind of usages in FM 3. (Or even in FM2, though I think
> things will be worked out in FM 3 a

Re: FreeMarker Project Maturity Model Assessment

Does Confluence work well for developer topics though? Because I guess
we will want to use it for FM3. I had to use it on workplace, a
relatively old version, and it was a nightmare because it gets
confused by the odd stuff we programmers write... and yes, there are
some escaping rules and all, but over all it wasn't practical to use,
plus it was buggy... though yet again maybe nowadays it's better.

Saturday, January 7, 2017, 7:17:07 PM, Jacques Le Roux wrote:

> I'd prefer Confluence as we have experience with it in the OFBiz team
>
> My 2cts
>
> Jacques
>
>
> Le 07/01/2017 à 18:49, Jacopo Cappellato a écrit :
>> On Sat, Jan 7, 2017 at 6:47 PM, Daniel Dekany  wrote:
>>
>>> We have never requested a wiki from infra... so I as far as know we
>>> don't have it yet.
>>
>> Should we request one? It can be useful to work together on a shared
>> document like in this case. Suggestions/proposals/preferences?
>>
>> Jacopo
>>
>
>

-- 
Thanks,
 Daniel Dekany

Re: Using Social Media to Help Promote Freemarker

Saturday, January 7, 2017, 6:55:14 PM, Jacopo Cappellato wrote:

> On Sat, Jan 7, 2017 at 6:45 PM, Daniel Dekany  wrote:
>
>> [...]
>> Also, a separate project (again, still under the umbrella of
>> FreeMarker and Apache) means that you can do releases independently of
>> the FreeMarker (the engine) project releases.
>>
>>
> Just to clarify: I guess you are talking about a separate *git* project,
> maintained by the FreeMarker community.
> Am I getting it right?

Yes. So then, it's a separate *product*.

> I am asking because, following the ASF terminology we have:
> * the FreeMarker *project* with a PMC, committers (this) mailing list etc..
> * one or more products: freemarker (the engine), freemarker-site,
> freemarker-docgen, freemarker-tester etc...
> The source files of each products are maintained in a separate git
> repository and may be released independently from each other.
>
> Jacopo

-- 
Thanks,
 Daniel Dekany

Re: FreeMarker Project Maturity Model Assessment

What about the github pages / wiki? Would bring code and documentation
close together.

Am 07.01.2017 7:17 nachm. schrieb "Jacques Le Roux" <
jacques.le.r...@les7arts.com>:

> I'd prefer Confluence as we have experience with it in the OFBiz team
>
> My 2cts
>
> Jacques
>
>
> Le 07/01/2017 à 18:49, Jacopo Cappellato a écrit :
>
>> On Sat, Jan 7, 2017 at 6:47 PM, Daniel Dekany 
>> wrote:
>>
>> We have never requested a wiki from infra... so I as far as know we
>>> don't have it yet.
>>>
>>
>> Should we request one? It can be useful to work together on a shared
>> document like in this case. Suggestions/proposals/preferences?
>>
>> Jacopo
>>
>>
>

-- 
Synesty GmbH
Moritz-von-Rohr-Str. 1a
07745 Jena
Tel.: +49 3641 559649
Fax.: +49 3641 5596499
Internet: http://synesty.com

Geschäftsführer: Christoph Rüger
Unternehmenssitz: Jena
Handelsregister B beim Amtsgericht: Jena
Handelsregister-Nummer: HRB 508766
Ust-IdNr.: DE287564982

Re: FreeMarker Project Maturity Model Assessment

2017-01-07 Thread Jacques Le Roux


I'd prefer Confluence as we have experience with it in the OFBiz team

My 2cts

Jacques


Le 07/01/2017 à 18:49, Jacopo Cappellato a écrit :

On Sat, Jan 7, 2017 at 6:47 PM, Daniel Dekany  wrote:


We have never requested a wiki from infra... so I as far as know we
don't have it yet.


Should we request one? It can be useful to work together on a shared
document like in this case. Suggestions/proposals/preferences?

Jacopo

Re: Using Social Media to Help Promote Freemarker

On Sat, Jan 7, 2017 at 6:45 PM, Daniel Dekany  wrote:

> [...]
> Also, a separate project (again, still under the umbrella of
> FreeMarker and Apache) means that you can do releases independently of
> the FreeMarker (the engine) project releases.
>
>
Just to clarify: I guess you are talking about a separate *git* project,
maintained by the FreeMarker community.
Am I getting it right?
I am asking because, following the ASF terminology we have:
* the FreeMarker *project* with a PMC, committers (this) mailing list etc..
* one or more products: freemarker (the engine), freemarker-site,
freemarker-docgen, freemarker-tester etc...
The source files of each products are maintained in a separate git
repository and may be released independently from each other.

Jacopo

Re: FreeMarker Project Maturity Model Assessment

On Sat, Jan 7, 2017 at 6:47 PM, Daniel Dekany  wrote:

> We have never requested a wiki from infra... so I as far as know we
> don't have it yet.


Should we request one? It can be useful to work together on a shared
document like in this case. Suggestions/proposals/preferences?

Jacopo

Re: PPMC members, please check our January Poddling Report!

I would like to highlight that FreeMarker is, at the moment, the only
project in this batch of reports for which all mentors had signed it off.

Thank you!

Jacopo

Re: FreeMarker Project Maturity Model Assessment

We have never requested a wiki from infra... so I as far as know we
don't have it yet.


Saturday, January 7, 2017, 6:41:12 PM, Michael Brohl wrote:

> Hi Jacopo,
>
> I would be happy to help setting up a wiki page for the maturity model.
>
> Where should we post this? At a first glance, I cannot find a wiki. Any
> hint is appreciated.
>
> Regards,
>
> Michael
>
>
> Am 07.01.17 um 16:55 schrieb Jacopo Cappellato:
>> Hi all,
>>
>> in preparation to the FreeMarker project's graduation, it would be useful
>> to prepare the Project Maturity Model Assessment.
>>
>> For more information on the Project Maturity Model see:
>> http://community.apache.org/apache-way/apache-project-maturity-model.html
>>
>> This is an example of the answers provided by a project that is under
>> graduation vote now:
>>
>> https://cwiki.apache.org/confluence/display/RANGER/Apache+Ranger+Project+Maturity+Model
>>
>> This is not mandatory, but I think that taking time to diligently complete
>> the answers may be useful for this project both as an internal assessment
>> and as a document that we will share to the Incubator PMC when they will be
>> called to vote for the graduation.
>>
>> What do you think?
>> Any volunteer to create a page in our wiki that we could use to work at the
>> document together?
>>
>> Kind regards,
>>
>> Jacopo
>>
>
>

-- 
Thanks,
 Daniel Dekany

Re: Using Social Media to Help Promote Freemarker

Saturday, January 7, 2017, 4:37:12 PM, Denis Bredelet wrote:

[snip]
>> These are some getting started examples. What are your ideas about the
>> final product?
>
> I am thinking of adding a « main » function in the FreeMarker JAR
> to load a template and a model (as XML or properties, that is why I
> showed the link). Then create a separate JAR with the UI to load the
> template and datamodel from the filesystem or define a datamodel
> interactively, and save the processed template in a file.

The whole functionality, even if it's only a console app with a main
method, should be in a separate jar, and certainly even in a separate
project (like we have freemarker-site, freemarker-docgen, and then we
could have freemarker-tester or something). Since dependency
management has become common place, it's considered to be a bad
practice to overpack your jar-s. In fact, something that we consider
to do in FM3 is exploding freemarker.jar into submodules (like
freemarker-servet.jar, etc.). Back then it was more practical to make
a big monolithic jar, but times are changing.

Also, a separate project (again, still under the umbrella of
FreeMarker and Apache) means that you can do releases independently of
the FreeMarker (the engine) project releases.

Also note that "main" methods in a library are seen as security
problems nowadays. We already have a bunch of them in freemarker.jar,
and I'm just waiting for the right moment to get rid of them.

So, yeah, I say, separate jar, separate project.

-- 
Thanks,
 Daniel Dekany

Re: FreeMarker Project Maturity Model Assessment

2017-01-07 Thread Michael Brohl


Hi Jacopo,

I would be happy to help setting up a wiki page for the maturity model.

Where should we post this? At a first glance, I cannot find a wiki. Any 
hint is appreciated.


Regards,

Michael


Am 07.01.17 um 16:55 schrieb Jacopo Cappellato:

Hi all,

in preparation to the FreeMarker project's graduation, it would be useful
to prepare the Project Maturity Model Assessment.

For more information on the Project Maturity Model see:
http://community.apache.org/apache-way/apache-project-maturity-model.html

This is an example of the answers provided by a project that is under
graduation vote now:

https://cwiki.apache.org/confluence/display/RANGER/Apache+Ranger+Project+Maturity+Model

This is not mandatory, but I think that taking time to diligently complete
the answers may be useful for this project both as an internal assessment
and as a document that we will share to the Incubator PMC when they will be
called to vote for the graduation.

What do you think?
Any volunteer to create a page in our wiki that we could use to work at the
document together?

Kind regards,

Jacopo






smime.p7s
Description: S/MIME Cryptographic Signature

Re: Using Social Media to Help Promote Freemarker

Saturday, January 7, 2017, 2:38:16 PM, Christoph Rüger wrote:

> regarding promoting freemarker: 
> We are already doing that  in our Cloud-Data-platform where you can
> use freemarker to do almost anything to transform, map and manipulate data.
> We use it for our own application too (all templates) but we also
> have chosen Freemarker as the main internal scripting language for data 
> transformation.
>
> Here is a small example which just concatenates two variables in
> the column "newtitle". Check it out if you want. It goes in a
> similar direction as  http://freemarker-online.kenshoo.com/
>
> That being said I think we are also happy to contribute interesting
> usecases, examples and whatever which could be spread using
> SocialMedia. We have lots of examples in our own documentation
> (here)

I would only answer to this as technical guy.

Your use cases are interesting in that you want not-so-technical
people to write templates. For example, apparently, you have hard time
dealing with null-s in your application (lot of `exp!`-s everywhere),
so you may want to chime in when the null/missing handling
improvements in FM3 are discussed.

BTW I see some examples like ${datecalc("HOUR", 1)!?datetime}. I guess
you can't possibly get a null there. Even if you do, ?datetime will be
unhappy with the '' it had to convert to date-time, unless you have a
custom data-time format there.

> (it"s german...just use google translator) where we show how to do
> various stuff with Freemarker expressions. We have also written some
> own functions (here) which could also be useful maybe as core
> built-ins (see here)

Some questions/notes...

How does `escapeHTML(exp)` differ from `exp?html`?

What's the practical use of `unescapeHTML(exp)`?

Also note that there's the auto-escaping machinery (output formats,
?esc, etc.) nowadays. It tries to removing the responsibility of
escaping from the template author (without using #escape, which itself
can be forgotten, or had to be added with TemplateLoader hacks). You
can have HTML fragments in the data-model that are automatically *not*
escaped, and everything else is automatically escaped. But even if
your data-model can't be made that smart (i.e. HTML is also Space), at
least you escape be default (and the you can do exp?noEsc to prevent
it), which is safer than the opposite.

As of `now()`, we have `.now`, though that returns a java.util.Date
instead of a long. So the equivalent is `.now?long`, which is somewhat
ugly. Note sure why and how often do you need the numerical version
though.

> Just let me know if this is interesting, so we can think about
> concrete stuff we could contribute where it fits. 

Calendar arithmetic is something users often request (i.e., adding a
day, truncating the date down to the beginning of the month/day/hour
and such). Anyway, if you have some concrete recommendation for
built-ins, tell us.

I'm interested to hear what your major pain points with FM are. A
single template engine can't be ideal for everyone, but I'm hoping to
cover more kind of usages in FM 3. (Or even in FM2, though I think
things will be worked out in FM 3 and then maybe ported back where
possible and if we have the resources).

> I don't want this to be considered spam - so let me know what you
> think... but of course it would be promotion for us too  
>
> Christoph
>
>
>
>
>
> 2017-01-07 13:36 GMT+01:00 Daniel Dekany :
> Saturday, January 7, 2017, 9:37:36 AM, Denis Bredelet wrote:
>
>> Hi Daniel,
>>
 That was also my impression on the OFBiz tweet, as a software
 developer. The last is important, that I'm looking at it as a
 developer. FreeMarker, unless OFBiz, is mostly only interesting for
 them I believe. It doesn't have an UI that a manager type could click
 around. It's not a complete end-user product, it's Java library used
 internally by other products.
>>
>> I am thinking of contributing a very simple UI for FreeMarker.
>> Something able to read a single template and process it with a
>> datamodel pulled from various sources (user interface window, properties 
>> file, XML file…)
>>
>> Would that be useful and help with advertising FreeMarker?
>
> I believe it's something that many users need, because it's not always
> convenient to try things right in the real product that integrates
> FreeMarker. Especially if you just want the wrap your head around
> something you have just read in the Manual. So I was considering
> creating a such GUI, only my priorities (core maintenance) didn't
> allow that. And then suddenly come
> http://freemarker-online.kenshoo.com/, so we do have something like
> that, but it could be improved further, also perhaps an offline
> version (like a SWT application or such) can be handy (if you want to
> connect to a local DB, etc).
>
> These template evaluators are also useful to draw the user's attention
> to best practices and features. Like if you go to
> http://freemarker-online.kenshoo.com/, you will be aware of ou

FreeMarker Project Maturity Model Assessment

Hi all,

in preparation to the FreeMarker project's graduation, it would be useful
to prepare the Project Maturity Model Assessment.

For more information on the Project Maturity Model see:
http://community.apache.org/apache-way/apache-project-maturity-model.html

This is an example of the answers provided by a project that is under
graduation vote now:

https://cwiki.apache.org/confluence/display/RANGER/Apache+Ranger+Project+Maturity+Model

This is not mandatory, but I think that taking time to diligently complete
the answers may be useful for this project both as an internal assessment
and as a document that we will share to the Incubator PMC when they will be
called to vote for the graduation.

What do you think?
Any volunteer to create a page in our wiki that we could use to work at the
document together?

Kind regards,

Jacopo

Re: Using Social Media to Help Promote Freemarker

2017-01-07 Thread Taher Alkhateeb

Hi Denis,

Perhaps we can do that in Gradle since talk was going in another thread of
making a switch. I'm working on a first draft.

On Jan 7, 2017 6:37 PM, "Denis Bredelet"  wrote:


> Le 7 janv. 2017 à 12:36, Daniel Dekany  a écrit :
>
> Saturday, January 7, 2017, 9:37:36 AM, Denis Bredelet wrote:
>
>> Hi Daniel,
>>
 That was also my impression on the OFBiz tweet, as a software
 developer. The last is important, that I'm looking at it as a
 developer. FreeMarker, unless OFBiz, is mostly only interesting for
 them I believe. It doesn't have an UI that a manager type could click
 around. It's not a complete end-user product, it's Java library used
 internally by other products.
>>
>> I am thinking of contributing a very simple UI for FreeMarker.
>> Something able to read a single template and process it with a
>> datamodel pulled from various sources (user interface window, properties
file, XML file…)
>>
>> Would that be useful and help with advertising FreeMarker?
>
> I believe it's something that many users need, because it's not always
> convenient to try things right in the real product that integrates
> FreeMarker. Especially if you just want the wrap your head around
> something you have just read in the Manual. So I was considering
> creating a such GUI, only my priorities (core maintenance) didn't
> allow that. And then suddenly come
> http://freemarker-online.kenshoo.com/, so we do have something like
> that, but it could be improved further, also perhaps an offline
> version (like a SWT application or such) can be handy (if you want to
> connect to a local DB, etc).
>
> These template evaluators are also useful to draw the user's attention
> to best practices and features. Like if you go to
> http://freemarker-online.kenshoo.com/, you will be aware of output
> formats, a relatively novel but very useful feature.
>
>> I have some code to use as a starting point on my website:
>> http://bredelet.com/Denis/FreeMarker%20first%20steps.html
>
> These are some getting started examples. What are your ideas about the
> final product?

I am thinking of adding a « main » function in the FreeMarker JAR to load a
template and a model (as XML or properties, that is why I showed the link).
Then create a separate JAR with the UI to load the template and datamodel
from the filesystem or define a datamodel interactively, and save the
processed template in a file.

Cheers,
— Denis.

>> Maybe this could come as a separate JAR to avoid loading UI classes
unnecessarily.
>
>> Cheers,
>> — Denis.
>
> --
> Thanks,
> Daniel Dekany
>

Re: Using Social Media to Help Promote Freemarker

2017-01-07 Thread Denis Bredelet


> Le 7 janv. 2017 à 12:36, Daniel Dekany  a écrit :
> 
> Saturday, January 7, 2017, 9:37:36 AM, Denis Bredelet wrote:
> 
>> Hi Daniel,
>> 
 That was also my impression on the OFBiz tweet, as a software
 developer. The last is important, that I'm looking at it as a
 developer. FreeMarker, unless OFBiz, is mostly only interesting for
 them I believe. It doesn't have an UI that a manager type could click
 around. It's not a complete end-user product, it's Java library used
 internally by other products.
>> 
>> I am thinking of contributing a very simple UI for FreeMarker.
>> Something able to read a single template and process it with a
>> datamodel pulled from various sources (user interface window, properties 
>> file, XML file…)
>> 
>> Would that be useful and help with advertising FreeMarker?
> 
> I believe it's something that many users need, because it's not always
> convenient to try things right in the real product that integrates
> FreeMarker. Especially if you just want the wrap your head around
> something you have just read in the Manual. So I was considering
> creating a such GUI, only my priorities (core maintenance) didn't
> allow that. And then suddenly come
> http://freemarker-online.kenshoo.com/, so we do have something like
> that, but it could be improved further, also perhaps an offline
> version (like a SWT application or such) can be handy (if you want to
> connect to a local DB, etc).
> 
> These template evaluators are also useful to draw the user's attention
> to best practices and features. Like if you go to
> http://freemarker-online.kenshoo.com/, you will be aware of output
> formats, a relatively novel but very useful feature.
> 
>> I have some code to use as a starting point on my website:
>> http://bredelet.com/Denis/FreeMarker%20first%20steps.html
> 
> These are some getting started examples. What are your ideas about the
> final product?

I am thinking of adding a « main » function in the FreeMarker JAR to load a 
template and a model (as XML or properties, that is why I showed the link). 
Then create a separate JAR with the UI to load the template and datamodel from 
the filesystem or define a datamodel interactively, and save the processed 
template in a file.

Cheers,
— Denis.

>> Maybe this could come as a separate JAR to avoid loading UI classes 
>> unnecessarily.
> 
>> Cheers,
>> — Denis.
> 
> -- 
> Thanks,
> Daniel Dekany
>

Re: Using Social Media to Help Promote Freemarker

regarding promoting freemarker:
We are already doing that  in our Cloud-Data-platform where you can use
freemarker to do almost anything to transform, map and manipulate data.
We use it for our own application too (all templates) but we also have
chosen Freemarker as the main internal scripting language for data
transformation.

Here is a small example

which
just concatenates two variables in the column "newtitle". Check it out if
you want. It goes in a similar direction as  http://freemarker-online.
kenshoo.com/

That being said I think we are also happy to contribute interesting
usecases, examples and whatever which could be spread using SocialMedia. We
have lots of examples in our own documentation (here
)
(it"s german...just use google translator) where we show how to do various
stuff with Freemarker expressions. We have also written some own functions (
here
)
which could also be useful maybe as core built-ins (see here

)

Just let me know if this is interesting, so we can think about concrete
stuff we could contribute where it fits.

I don't want this to be considered spam - so let me know what you think...
but of course it would be promotion for us too :)

Christoph

2017-01-07 13:36 GMT+01:00 Daniel Dekany :

> Saturday, January 7, 2017, 9:37:36 AM, Denis Bredelet wrote:
>
> > Hi Daniel,
> >
> >>> That was also my impression on the OFBiz tweet, as a software
> >>> developer. The last is important, that I'm looking at it as a
> >>> developer. FreeMarker, unless OFBiz, is mostly only interesting for
> >>> them I believe. It doesn't have an UI that a manager type could click
> >>> around. It's not a complete end-user product, it's Java library used
> >>> internally by other products.
> >
> > I am thinking of contributing a very simple UI for FreeMarker.
> > Something able to read a single template and process it with a
> > datamodel pulled from various sources (user interface window, properties
> file, XML file…)
> >
> > Would that be useful and help with advertising FreeMarker?
>
> I believe it's something that many users need, because it's not always
> convenient to try things right in the real product that integrates
> FreeMarker. Especially if you just want the wrap your head around
> something you have just read in the Manual. So I was considering
> creating a such GUI, only my priorities (core maintenance) didn't
> allow that. And then suddenly come
> http://freemarker-online.kenshoo.com/, so we do have something like
> that, but it could be improved further, also perhaps an offline
> version (like a SWT application or such) can be handy (if you want to
> connect to a local DB, etc).
>
> These template evaluators are also useful to draw the user's attention
> to best practices and features. Like if you go to
> http://freemarker-online.kenshoo.com/, you will be aware of output
> formats, a relatively novel but very useful feature.
>
> > I have some code to use as a starting point on my website:
> > http://bredelet.com/Denis/FreeMarker%20first%20steps.html
>
> These are some getting started examples. What are your ideas about the
> final product?
>
> > Maybe this could come as a separate JAR to avoid loading UI classes
> unnecessarily.
>
> > Cheers,
> > — Denis.
>
> --
> Thanks,
>  Daniel Dekany
>
>

-- 
Christoph Rüger, Geschäftsführer
Synesty  - Automatisierung, Schnittstellen, Datenfeeds
Tel.: +49 3641/559649

Xing: https://www.xing.com/profile/Christoph_Rueger2
LinkedIn: http://www.linkedin.com/pub/christoph-rueger/a/685/198

-- 
Synesty GmbH
Moritz-von-Rohr-Str. 1a
07745 Jena
Tel.: +49 3641 559649
Fax.: +49 3641 5596499
Internet: http://synesty.com

Geschäftsführer: Christoph Rüger
Unternehmenssitz: Jena
Handelsregister B beim Amtsgericht: Jena
Handelsregister-Nummer: HRB 508766
Ust-IdNr.: DE287564982

Re: Using Social Media to Help Promote Freemarker

Saturday, January 7, 2017, 9:37:36 AM, Denis Bredelet wrote:

> Hi Daniel,
>
>>> That was also my impression on the OFBiz tweet, as a software
>>> developer. The last is important, that I'm looking at it as a
>>> developer. FreeMarker, unless OFBiz, is mostly only interesting for
>>> them I believe. It doesn't have an UI that a manager type could click
>>> around. It's not a complete end-user product, it's Java library used
>>> internally by other products.
>
> I am thinking of contributing a very simple UI for FreeMarker.
> Something able to read a single template and process it with a
> datamodel pulled from various sources (user interface window, properties 
> file, XML file…)
>
> Would that be useful and help with advertising FreeMarker?

I believe it's something that many users need, because it's not always
convenient to try things right in the real product that integrates
FreeMarker. Especially if you just want the wrap your head around
something you have just read in the Manual. So I was considering
creating a such GUI, only my priorities (core maintenance) didn't
allow that. And then suddenly come
http://freemarker-online.kenshoo.com/, so we do have something like
that, but it could be improved further, also perhaps an offline
version (like a SWT application or such) can be handy (if you want to
connect to a local DB, etc).

These template evaluators are also useful to draw the user's attention
to best practices and features. Like if you go to
http://freemarker-online.kenshoo.com/, you will be aware of output
formats, a relatively novel but very useful feature.

> I have some code to use as a starting point on my website:
> http://bredelet.com/Denis/FreeMarker%20first%20steps.html

These are some getting started examples. What are your ideas about the
final product?

> Maybe this could come as a separate JAR to avoid loading UI classes 
> unnecessarily.

> Cheers,
> — Denis.

-- 
Thanks,
 Daniel Dekany

Re: About a Freemarker template evaluator service

Thanks, looks good to me!

I have added a comment regarding the resource needs:

  Regarding the resource requirements... My guess is that it will run
  fine with 256 MB RAM and a few GB of HDD (Linux "core" + Java, some
  application logs). As of the CPU, I think we will almost always run
  fine with 1 core, though it would be safer if we can tap on some
  extra virtual cores, just in case some spike comes.

-- 
Thanks,
 Daniel Dekany


Saturday, January 7, 2017, 11:42:14 AM, Jacques Le Roux wrote:

> Done at
> https://issues.apache.org/jira/servicedesk/customer/portal/1/INFRA-13246
> feel free to comment/modify/improve
>
> Jacques
>
>
> Le 05/01/2017 à 22:33, Jacques Le Roux a écrit :
>> Hi Jacopo,
>>
>> Yes I'll try to discuss it with the infra team tomorrow, at least this 
>> weekend...
>>
>> Jacques
>>
>>
>> Le 04/01/2017 à 19:59, Jacopo Cappellato a écrit :
>>> Thank you Jacques! Are you going to submit the request to the Infra team?
>>> As soon as we have it setup we will plan the next moves. Please keep this
>>> list posted with any progress or questions you may have to complete this
>>> task.
>>>
>>> Jacopo
>>>
>>> On Tue, Jan 3, 2017 at 12:53 PM, Jacques Le Roux <
>>> jacques.le.r...@les7arts.com> wrote:
>>>
 Le 03/01/2017 à 09:32, Jacopo Cappellato a écrit :

> Hi all,
>
> a couple of days ago Daniel brought to my attention the site/service:
>
> http://freemarker-online.kenshoo.com/
>
> They provide a nice online tool to evaluate any Freemarker template by
> providing the template code and its context.
>
> Wouldn't be nice is we could offer that or a similar service to the users
> and potential adopters of Freemarker? I think it would be a very useful
> tool and also a good mechanism to attract new consumers.
>
> If there is an interest in this community then we could move in two
> directions:
>
> 1) get in touch with the maintainers of freemarker-online and see if they
> are interested to contribute their work [*] or join our community and help
> to build a similar one here; if they are not interested then we could
> discuss if it would make sense to build our own here
>
> 2) get in touch with the Infra team and explore the possibility to set up
> a
> virtual machine to dedicated to our project that we could use to deploy a
> similar service, from our official website
>
> I can volunteer to try to get in touch with them (#1); any volunteers for
> #2 (or even #1)?
>
> Kind regards,
>
> Jacopo
>
> [*] which is licensed with the AL2.0 and available here:
> https://github.com/kenshoo/freemarker-online
>
> Hi Jacopo,
 I can take care of 2, I'm used to these kind of things for OFBiz
 I guess 1 is a prerequisite and I'm not well placed for this task.

 Jacques


>>
>>
>
>

Re: About a Freemarker template evaluator service

2017-01-07 Thread Jacques Le Roux


Done at 
https://issues.apache.org/jira/servicedesk/customer/portal/1/INFRA-13246 feel 
free to comment/modify/improve

Jacques


Le 05/01/2017 à 22:33, Jacques Le Roux a écrit :

Hi Jacopo,

Yes I'll try to discuss it with the infra team tomorrow, at least this 
weekend...

Jacques


Le 04/01/2017 à 19:59, Jacopo Cappellato a écrit :

Thank you Jacques! Are you going to submit the request to the Infra team?
As soon as we have it setup we will plan the next moves. Please keep this
list posted with any progress or questions you may have to complete this
task.

Jacopo

On Tue, Jan 3, 2017 at 12:53 PM, Jacques Le Roux <
jacques.le.r...@les7arts.com> wrote:


Le 03/01/2017 à 09:32, Jacopo Cappellato a écrit :


Hi all,

a couple of days ago Daniel brought to my attention the site/service:

http://freemarker-online.kenshoo.com/

They provide a nice online tool to evaluate any Freemarker template by
providing the template code and its context.

Wouldn't be nice is we could offer that or a similar service to the users
and potential adopters of Freemarker? I think it would be a very useful
tool and also a good mechanism to attract new consumers.

If there is an interest in this community then we could move in two
directions:

1) get in touch with the maintainers of freemarker-online and see if they
are interested to contribute their work [*] or join our community and help
to build a similar one here; if they are not interested then we could
discuss if it would make sense to build our own here

2) get in touch with the Infra team and explore the possibility to set up
a
virtual machine to dedicated to our project that we could use to deploy a
similar service, from our official website

I can volunteer to try to get in touch with them (#1); any volunteers for
#2 (or even #1)?

Kind regards,

Jacopo

[*] which is licensed with the AL2.0 and available here:
https://github.com/kenshoo/freemarker-online

Hi Jacopo,

I can take care of 2, I'm used to these kind of things for OFBiz
I guess 1 is a prerequisite and I'm not well placed for this task.

Jacques

Re: Using Social Media to Help Promote Freemarker

On Fri, Jan 6, 2017 at 9:06 PM, Sharan Foga  wrote:

> [...]

Anyway - we could maybe look at trying to do something over a short
> timeframe  (like a POC) to see how it works... :-)   What do people think?
>

I like the idea of running an experiment to increase the activity in
Twitter and slowly broaden, without exaggerations, the content: not just
formal ones (like it is now) but also informal and casual ones. I am sure
that in a few weeks, with the feedback of this community, we could fine
tune the messages to be well suited to the specific needs and style of the
FreeMarker community.
We could run this experiment, with the help of Sharan, for, let's say, 2
months (providing our feedback to her in the meantime) and then measure the
results (in terms of subscriptions, feedback etc...).
We could do something similar with the blog.

I also think it is useful and beneficial to the project some separation of
concerns: the more technical wise ones can focus their energy on code and
technical aspects of the project, while others can in parallel help with
content, documentation, communication.

Anyway, this is a great conversation, thank you all.

Jacopo

Re: Completing the copyright footer of the FreeMarker website

On Fri, Jan 6, 2017 at 8:55 PM, Daniel Dekany  wrote:

> I have added the trademark notice to the footer (see on
> http://freemarker.org/). I have removed the "All rights reserved."
> part, as it weren't used on the OFBiz page either. (The Manual wasn't
> regenerated, so it's footer is not update... can wait until 2.3.26, I
> assume.)
>
>
Thank you Daniel, it looks great to me.

Jacopo

Re: Using Social Media to Help Promote Freemarker