Re: Have a README.TXT file in release package

[Taher Alkhateeb]

If I see two README files in a project, I would get confused. Conventions are 
usually that there is only one README, one LICENSE, one INSTALL and so on ...

Perhaps another approach is to slimdown the README file and refer to other 
documentation using links to the other resources. This way you can emphasize 
any point you want in the main README and leave the other less used 
documentation for elsewhere.


On Sunday, May 10, 2020 19:43 +03, Jacques Le Roux 
 wrote:
 Hi,

We often get questions from people not reading the basic documentation. Like 
not able to run Gradle because ignoring init-gradle-wrapper scripts.

I know there will always people not reading the documentation. But maybe, to 
prevent most obvious questions and tempting RTFM answers, we could add a
small README.TXT with basic information in OFBiz root.

It would ultimately refer to README.adoc. Also saying that README.adoc can be 
read with a text reader tool. And it's easy to follow
https://asciidoctor.org/docs/convert-documents/#converting-a-document-to-html

What do you think?

Jacques
 
 

Re: Have a README.TXT file in release package

[Pierre Smits]

Call it INSTALLATION, and simply highlight what is necessary to get OFBiz
running:
Have jdk, version 8
invoke the gradle-init script

I concur with Michael, people who don't read the readme.adoc will possibly
forgo the other readme too.

Met vriendelijke groet,

Pierre Smits
*Proud* *contributor** of* Apache OFBiz  since
2008 (without privileges)

*Apache Trafodion , Vice President*
*Apache Directory , PMC Member*
Apache Incubator , committer
Apache Steve , committer


On Sun, May 10, 2020 at 7:29 PM Michael Brohl 
wrote:

> Hi Jacques,
>
> do you think that people who do not read README.adoc would rather read a
> README.txt file?
>
> I doubt that you'll reach those people with that file but it might be
> worth a try. I would name the file README without extension to better
> match LICENSE, NOTICE, VERSION etc..
>
> Thanks,
>
> Michael Brohl
>
> ecomify GmbH - www.ecomify.de
>
>
> Am 10.05.20 um 18:43 schrieb Jacques Le Roux:
> > Hi,
> >
> > We often get questions from people not reading the basic
> > documentation. Like not able to run Gradle because ignoring
> > init-gradle-wrapper scripts.
> >
> > I know there will always people not reading the documentation. But
> > maybe, to prevent most obvious questions and tempting RTFM answers, we
> > could add a small README.TXT with basic information in OFBiz root.
> >
> > It would ultimately refer to README.adoc. Also saying that README.adoc
> > can be read with a text reader tool. And it's easy to follow
> >
> https://asciidoctor.org/docs/convert-documents/#converting-a-document-to-html
> >
> > What do you think?
> >
> > Jacques
> >
>
>

Re: Have a README.TXT file in release package

[Michael Brohl]

Hi Jacques,

do you think that people who do not read README.adoc would rather read a 
README.txt file?


I doubt that you'll reach those people with that file but it might be 
worth a try. I would name the file README without extension to better 
match LICENSE, NOTICE, VERSION etc..


Thanks,

Michael Brohl

ecomify GmbH - www.ecomify.de


Am 10.05.20 um 18:43 schrieb Jacques Le Roux:

Hi,

We often get questions from people not reading the basic 
documentation. Like not able to run Gradle because ignoring 
init-gradle-wrapper scripts.


I know there will always people not reading the documentation. But 
maybe, to prevent most obvious questions and tempting RTFM answers, we 
could add a small README.TXT with basic information in OFBiz root.


It would ultimately refer to README.adoc. Also saying that README.adoc 
can be read with a text reader tool. And it's easy to follow 
https://asciidoctor.org/docs/convert-documents/#converting-a-document-to-html


What do you think?

Jacques





smime.p7s
Description: S/MIME Cryptographic Signature

Re: Have a README.TXT file in release package

[Deepak Nigam]

+1

Thanks & Regards
--
Deepak Nigam



On Sun, May 10, 2020, 10:15 PM Jacques Le Roux 
wrote:

> Hi,
>
> We often get questions from people not reading the basic documentation.
> Like not able to run Gradle because ignoring init-gradle-wrapper scripts.
>
> I know there will always people not reading the documentation. But maybe,
> to prevent most obvious questions and tempting RTFM answers, we could add a
> small README.TXT with basic information in OFBiz root.
>
> It would ultimately refer to README.adoc. Also saying that README.adoc can
> be read with a text reader tool. And it's easy to follow
>
> https://asciidoctor.org/docs/convert-documents/#converting-a-document-to-html
>
> What do you think?
>
> Jacques
>
>

Have a README.TXT file in release package

[Jacques Le Roux]

Hi,

We often get questions from people not reading the basic documentation. Like 
not able to run Gradle because ignoring init-gradle-wrapper scripts.

I know there will always people not reading the documentation. But maybe, to prevent most obvious questions and tempting RTFM answers, we could add a 
small README.TXT with basic information in OFBiz root.


It would ultimately refer to README.adoc. Also saying that README.adoc can be read with a text reader tool. And it's easy to follow 
https://asciidoctor.org/docs/convert-documents/#converting-a-document-to-html


What do you think?

Jacques

Re: new script-template> widget

[Jacques Le Roux]

Hi James,

I  know it's not all of them as you already mentioned. But could not some these 
of these scripts be handled by Require.js?

Jacques

Le 10/05/2020 à 14:32, James Yong a écrit :

Hi Michael,

There are CSP errors being logged in the browser console, due to the use of 
inline javascripts.

The proposed method allow us to:
1. convert the inline javascripts into external scripts for better CSP 
compliance.
2. use freemarker macros in the scripts.
3. place the extracted javascript in the same directory as the original 
freemarker template file, to save time locating and editing the 2 related files.

Regards,
James

On 2020/05/10 09:53:47, Michael Brohl  wrote:

Hi James,

can you explain the purpose of this? Why not just use a JavaScript file
and a decorator?

Thanks,

Michael Brohl

ecomify GmbH - www.ecomify.de


Am 10.05.20 um 06:53 schrieb James Yong:

Hi all,

I have created a JIRA issue for this, i.e. OFBIZ-11686.
Decided not to have a placement attribute because script will always be placed 
after body tag.

Regards,
James

On 2020/05/07 11:48:32, James Yong  wrote:

Hi all,

Propose a new  widget tag that adds an external script inside 
html head tag, or after body tag. The external script will contain the rendered 
result of the specified template file location.
e.g.





This will allow inline script from a freemarker file, to be rendered as 
external script in html.

Regards,
James

Re: new script-template> widget

[James Yong]

Hi Michael,

There are CSP errors being logged in the browser console, due to the use of 
inline javascripts.

The proposed method allow us to:
1. convert the inline javascripts into external scripts for better CSP 
compliance. 
2. use freemarker macros in the scripts.
3. place the extracted javascript in the same directory as the original 
freemarker template file, to save time locating and editing the 2 related files.

Regards,
James

On 2020/05/10 09:53:47, Michael Brohl  wrote: 
> Hi James,
> 
> can you explain the purpose of this? Why not just use a JavaScript file 
> and a decorator?
> 
> Thanks,
> 
> Michael Brohl
> 
> ecomify GmbH - www.ecomify.de
> 
> 
> Am 10.05.20 um 06:53 schrieb James Yong:
> > Hi all,
> >
> > I have created a JIRA issue for this, i.e. OFBIZ-11686.
> > Decided not to have a placement attribute because script will always be 
> > placed after body tag.
> >
> > Regards,
> > James
> >
> > On 2020/05/07 11:48:32, James Yong  wrote:
> >> Hi all,
> >>
> >> Propose a new  widget tag that adds an external script 
> >> inside html head tag, or after body tag. The external script will contain 
> >> the rendered result of the specified template file location.
> >> e.g.
> >> 
> >>
> >> >> location="component://order/template/quote/test.ftl” placement=“head”/>
> >>
> >> will render as:
> >> 
> >>
> >>…
> >>

Re: Regarding Customization of Account and Billing Software

[Jacques Le Roux]

Hi Atul,

Your message has been moderated, else it would not have reached this Mailing 
List.

Please subscribe to the user ML for such questions and then use your email 
client.
See why here http://ofbiz.apache.org/mailing-lists.html.

You will get a better support, people can answer you on the ML.
The wider the audience the better the answers you might get.

Also it's more work for moderators who have to accept your messages as long as 
you have not subscribed.
I'll personally no longer accept them (other moderators still could).

Thanks

Jacques

Le 09/05/2020 à 22:04, Atul Dhengre a écrit :

Dear Team,

Kindly , share the manual to customize the accounting and Billing solution.
How to use existing accounting system of offbiz solutions and api is
available in offbiz.



Regards,
Atul

Re: Site and obsolete Svn info

[Jacques Le Roux]

Done by removing the last references to Svn

Le 04/05/2020 à 12:27, Jacques Le Roux a écrit :

Hi,

As I wrote in OFBIZ-11269 at https://s.apache.org/pf2ty, please consider:

We should change in the  "Committer Access" section of 
source-repositories.tpl.php

When you first connect you will be prompted to accept the SSL certificate. Verify the certificate is for svn.apache.org. After verification, select 
option 'P' to permanently add to your SVN configuration.
Subversion can handle keyword expansion, eol conversion as well as many other features. These features are configured at the server level (actually 
only in the OFBiz repository branch), so you don't have to worry about them


I propose

When you first connect you will be prompted to accept the SSL certificate. 
Verify the certificate.
Git handles keyword expansion, EOL conversion as well as many other features. These features are configured at the server level, so you don't have 
to worry about them


But I'm unsure if we should change
after verification, select option 'P' to permanently add to your SVN 
configuration.
or simply remove it...

What do you think?

Jacques

Re: new script-template> widget

[Michael Brohl]

Hi James,

can you explain the purpose of this? Why not just use a JavaScript file 
and a decorator?


Thanks,

Michael Brohl

ecomify GmbH - www.ecomify.de


Am 10.05.20 um 06:53 schrieb James Yong:

Hi all,

I have created a JIRA issue for this, i.e. OFBIZ-11686.
Decided not to have a placement attribute because script will always be placed 
after body tag.

Regards,
James

On 2020/05/07 11:48:32, James Yong  wrote:

Hi all,

Propose a new  widget tag that adds an external script inside 
html head tag, or after body tag. The external script will contain the rendered 
result of the specified template file location.
e.g.





This will allow inline script from a freemarker file, to be rendered as 
external script in html.

Regards,
James





smime.p7s
Description: S/MIME Cryptographic Signature

Re: Regarding Customization of Account and Billing Software

[Pierre Smits]

Hi Atul,

Information regarding customisation of OFBiz (both technically and
configuration-wise) is available in our wiki. See
https://cwiki.apache.org/confluence/display/OFBIZ/Home.

Met vriendelijke groet,

Pierre Smits
*Proud* *contributor** of* Apache OFBiz  since
2008 (without privileges)

*Apache Trafodion , Vice President*
*Apache Directory , PMC Member*
Apache Incubator , committer
Apache Steve , committer


On Sun, May 10, 2020 at 10:48 AM Atul Dhengre  wrote:

> Dear Team,
>
> Kindly , share the manual to customize the accounting and Billing solution.
> How to use existing accounting system of offbiz solutions and api is
> available in offbiz.
>
>
>
> Regards,
> Atul
>

Regarding Customization of Account and Billing Software

[Atul Dhengre]

Dear Team,

Kindly , share the manual to customize the accounting and Billing solution.
How to use existing accounting system of offbiz solutions and api is
available in offbiz.



Regards,
Atul