Re: [R] R License

2014-05-26 Thread Barry Rowlingson
On Sat, May 24, 2014 at 4:11 PM, Juan Ulises Bohorquez Carvajal
juan.bohorq...@ecopetrol.com.co wrote:
 Thanks, could you send to me an official certificate in pdf with this 
 information? Or a certified email to support the information license?

And what would be the authority that supplies such a certificate? R is
not the proprietary property of a company or person, so I don't think
a body exists that could supply such an authoritative email.

What does (or should) exist are the comments in the source files
explaining the license terms, and this is echoed in the banner message
on startup.

I'm sure if you asked very nicely you could get a letter from someone
held in high esteem by the R community - some professor at an ancient
university perhaps - stating their belief that you can use R for your
company in accordance with the licenses. But that would just be
repeating what you've already heard here. The licensing is with the
code, and clearly stated.

Other, larger companies use R extensively - see this recent blog entry:

http://blog.revolutionanalytics.com/2014/05/companies-using-r-in-2014.html

Note in particular the banner when R starts: ABSOLUTELY NO WARRANTY
- which means if a bug in R makes one of your gas processing plants
explode, there's probably nobody to sue - but if you read the small
print on proprietary software licenses you'll probably find similar
terms anyway. R puts it out there in block capitals every time.

Barry

 __
 R-help@r-project.org mailing list
 https://stat.ethz.ch/mailman/listinfo/r-help
 PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
 and provide commented, minimal, self-contained, reproducible code.

__
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.


Re: [R] R License

2014-05-26 Thread Juan Ulises Bohorquez Carvajal
Thanks

 Mensaje original 
De: Barry Rowlingson
Fecha:26/05/2014 03:11 AM (GMT-05:00)
A: Juan Ulises Bohorquez Carvajal
CC: John Kane ,r-help@R-project.org
Asunto: Re: [R] R License

On Sat, May 24, 2014 at 4:11 PM, Juan Ulises Bohorquez Carvajal
juan.bohorq...@ecopetrol.com.co wrote:
 Thanks, could you send to me an official certificate in pdf with this 
 information? Or a certified email to support the information license?

And what would be the authority that supplies such a certificate? R is
not the proprietary property of a company or person, so I don't think
a body exists that could supply such an authoritative email.

What does (or should) exist are the comments in the source files
explaining the license terms, and this is echoed in the banner message
on startup.

I'm sure if you asked very nicely you could get a letter from someone
held in high esteem by the R community - some professor at an ancient
university perhaps - stating their belief that you can use R for your
company in accordance with the licenses. But that would just be
repeating what you've already heard here. The licensing is with the
code, and clearly stated.

Other, larger companies use R extensively - see this recent blog entry:

http://blog.revolutionanalytics.com/2014/05/companies-using-r-in-2014.html

Note in particular the banner when R starts: ABSOLUTELY NO WARRANTY
- which means if a bug in R makes one of your gas processing plants
explode, there's probably nobody to sue - but if you read the small
print on proprietary software licenses you'll probably find similar
terms anyway. R puts it out there in block capitals every time.

Barry

 __
 R-help@r-project.org mailing list
 https://stat.ethz.ch/mailman/listinfo/r-help
 PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
 and provide commented, minimal, self-contained, reproducible code.


Este mensaje y sus anexos está dirigido para ser usado por su(s) 
destinatario(s) exclusivamente y puede contener información confidencial y/o 
reservada protegida legalmente. Si usted no es el destinatario, se le notifica 
que cualquier distribución o reproducción del mismo, o de cualquiera de sus 
anexos, está estrictamente prohibida. Si usted ha recibido este mensaje por 
error, por favor notifíquenos inmediatamente y elimine su texto original, 
incluidos los anexos, o destruya cualquier reproducción del mismo. Las 
opiniones expresadas en este mensaje son responsabilidad exclusiva de quien las 
emite y no necesariamente reflejan la posición institucional de Ecopetrol S.A. 
ni comprometen la responsabilidad institucional por el uso que el destinatario 
haga de las mismas. Este mensaje ha sido verificado con software antivirus. En 
consecuencia, Ecopetrol S.A. no se hace responsable por la presencia en él, o 
en sus anexos, de algún virus que pueda generar daños en los equipos o 
programas del destinatario.

This e-mail, and any attachments thereto, is intended for use by the 
addressee(s) named herein only and may contain legally privileged and/or 
confidential information. If you are not the recipient of this e-mail, you are 
hereby notified that any distribution or copying of this e-mail, and any 
attachments thereto, is strictly prohibited. If you have received this e-mail 
in error, please notify us immediately, permanently delete the original 
including attachments, and destroy any copy or printout thereof. The opinions 
contained in this message are the sole responsibility of the individual person 
who gives them and do not either necessarily reflect the institutional policy 
of Ecopetrol S.A. on the subject, or involve corporate responsibility for any 
use of them by the addressee(s). This message has been checked with antivirus 
software; therefore, Ecopetrol S.A. is not liable for the presence of any virus 
in the message or in its attachments that causes or may cause damage to the 
recipient's equipment or software.


[[alternative HTML version deleted]]

__
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.


Re: [R] R License

2014-05-24 Thread John Kane
It is an Open Source program and can be used by anyone.

John Kane
Kingston ON Canada


 -Original Message-
 From: juan.bohorq...@ecopetrol.com.co
 Sent: Sat, 24 May 2014 07:57:58 -0500
 To: r-help@r-project.org
 Subject: [R] R License
 
 Hello, I work in the area of b??b??Geomatics in  Ecopetrol,  Ecopetrol is
 an Oil  GAS company with 10,000 employees. The licensing of R allows me
 to use it in production at my company or academic use only?
 Sincerely,
 
 
 JB.


FREE 3D MARINE AQUARIUM SCREENSAVER - Watch dolphins, sharks  orcas on your 
desktop!

__
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.


Re: [R] R License

2014-05-24 Thread Timothy W. Cook
On Sat, May 24, 2014 at 9:57 AM, Juan Ulises Bohorquez Carvajal 
juan.bohorq...@ecopetrol.com.co wrote:

 Hello, I work in the area of ​​Geomatics in  Ecopetrol,  Ecopetrol is an
 Oil  GAS company with 10,000 employees. The licensing of R allows me to
 use it in production at my company or academic use only?
 Sincerely,



'R' like many open source applications, uses several licenses because it
includes several other open source components.  If you are concerned about
using R for commercial purposes or in a commercial environment then you (or
your attorney/legal dept.) should consult

http://www.r-project.org/Licenses/

The intent is for to to be available free, for wide use.  But no one else
knows your intended use case.

Cheers,
Tim




Timothy Cook
LinkedIn Profile:http://www.linkedin.com/in/timothywaynecook
MLHIM http://www.mlhim.org

[[alternative HTML version deleted]]

__
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.


Re: [R] R License

2014-05-24 Thread John Kane
Aha, someone knowledeable has shown up. Thanks Tim

John Kane
Kingston ON Canada


 -Original Message-
 From: t...@mlhim.org
 Sent: Sat, 24 May 2014 12:23:10 -0300
 To: juan.bohorq...@ecopetrol.com.co
 Subject: Re: [R] R License
 
 On Sat, May 24, 2014 at 9:57 AM, Juan Ulises Bohorquez Carvajal 
 juan.bohorq...@ecopetrol.com.co wrote:
 
 Hello, I work in the area of b??b??Geomatics in  Ecopetrol,  Ecopetrol
 is an
 Oil  GAS company with 10,000 employees. The licensing of R allows me to
 use it in production at my company or academic use only?
 Sincerely,
 
 
 
 'R' like many open source applications, uses several licenses because it
 includes several other open source components.  If you are concerned
 about
 using R for commercial purposes or in a commercial environment then you
 (or
 your attorney/legal dept.) should consult
 
 http://www.r-project.org/Licenses/
 
 The intent is for to to be available free, for wide use.  But no one else
 knows your intended use case.
 
 Cheers,
 Tim
 
 
 
 
 Timothy Cook
 LinkedIn Profile:http://www.linkedin.com/in/timothywaynecook
 MLHIM http://www.mlhim.org
 
   [[alternative HTML version deleted]]
 
 __
 R-help@r-project.org mailing list
 https://stat.ethz.ch/mailman/listinfo/r-help
 PLEASE do read the posting guide
 http://www.R-project.org/posting-guide.html
 and provide commented, minimal, self-contained, reproducible code.


FREE ONLINE PHOTOSHARING - Share your photos online with your friends and 
family!
Visit http://www.inbox.com/photosharing to find out more!

__
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.


Re: [R] R License

2014-05-24 Thread Jeff Newmiller
This is not an appropriate forum to be obtaining legal advice in. That said, 
the licenses [1] for R do not discuss the size of your company. They do discuss 
your rights and responsibilities should you make changes to R. People who want 
to modify or incorporate R in their own software tend to have to pay close 
attention to those terms while those who merely use it as-is tend to have less 
to worry about. Also keep in mind that much value is found in contributed 
packages that may have a variety of licenses, so be aware of those licenses as 
you add packages to your workflow.

You will probably find it useful in reading these licenses to familiarize 
yourself with the definition of Open Source. [2]

[1] http://www.r-project.org/Licenses/
[2] http://opensource.org/osd
---
Jeff NewmillerThe .   .  Go Live...
DCN:jdnew...@dcn.davis.ca.usBasics: ##.#.   ##.#.  Live Go...
  Live:   OO#.. Dead: OO#..  Playing
Research Engineer (Solar/BatteriesO.O#.   #.O#.  with
/Software/Embedded Controllers)   .OO#.   .OO#.  rocks...1k
--- 
Sent from my phone. Please excuse my brevity.

On May 24, 2014 5:57:58 AM PDT, Juan Ulises Bohorquez Carvajal 
juan.bohorq...@ecopetrol.com.co wrote:
Hello, I work in the area of ��Geomatics in  Ecopetrol,  Ecopetrol
is an Oil  GAS company with 10,000 employees. The licensing of R
allows me to use it in production at my company or academic use only?
Sincerely,


JB.


Este mensaje y sus anexos est�� dirigido para ser usado por su(s)
destinatario(s) exclusivamente y puede contener informaci��n
confidencial y/o reservada protegida legalmente. Si usted no es el
destinatario, se le notifica que cualquier distribuci��n o
reproducci��n del mismo, o de cualquiera de sus anexos, est��
estrictamente prohibida. Si usted ha recibido este mensaje por error,
por favor notif��quenos inmediatamente y elimine su texto original,
incluidos los anexos, o destruya cualquier reproducci��n del mismo. Las
opiniones expresadas en este mensaje son responsabilidad exclusiva de
quien las emite y no necesariamente reflejan la posici��n institucional
de Ecopetrol S.A. ni comprometen la responsabilidad institucional por
el uso que el destinatario haga de las mismas. Este mensaje ha sido
verificado con software antivirus. En consecuencia, Ecopetrol S.A. no
se hace responsable por la presencia en ��l, o en sus anexos, de alg��n
virus que pueda generar da��os en los equipos o programas del
destinatario.

This e-mail, and any attachments thereto, is intended for use by the
addressee(s) named herein only and may contain legally privileged
and/or confidential information. If you are not the recipient of this
e-mail, you are hereby notified that any distribution or copying of
this e-mail, and any attachments thereto, is strictly prohibited. If
you have received this e-mail in error, please notify us immediately,
permanently delete the original including attachments, and destroy any
copy or printout thereof. The opinions contained in this message are
the sole responsibility of the individual person who gives them and do
not either necessarily reflect the institutional policy of Ecopetrol
S.A. on the subject, or involve corporate responsibility for any use of
them by the addressee(s). This message has been checked with antivirus
software; therefore, Ecopetrol S.A. is not liable for the presence of
any virus in the message or in its attachments that causes or may cause
damage to the recipient's equipment or software.


   [[alternative HTML version deleted]]





__
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide
http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.

__
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.


Re: [R] R License

2014-05-24 Thread Juan Ulises Bohorquez Carvajal
Thanks

 Mensaje original 
De: Jeff Newmiller
Fecha:24/05/2014 10:37 AM (GMT-05:00)
A: Juan Ulises Bohorquez Carvajal ,r-help@R-project.org
Asunto: Re: [R] R License

This is not an appropriate forum to be obtaining legal advice in. That said, 
the licenses [1] for R do not discuss the size of your company. They do discuss 
your rights and responsibilities should you make changes to R. People who want 
to modify or incorporate R in their own software tend to have to pay close 
attention to those terms while those who merely use it as-is tend to have less 
to worry about. Also keep in mind that much value is found in contributed 
packages that may have a variety of licenses, so be aware of those licenses as 
you add packages to your workflow.

You will probably find it useful in reading these licenses to familiarize 
yourself with the definition of Open Source. [2]

[1] http://www.r-project.org/Licenses/
[2] http://opensource.org/osd
---
Jeff NewmillerThe .   .  Go Live...
DCN:jdnew...@dcn.davis.ca.usBasics: ##.#.   ##.#.  Live Go...
  Live:   OO#.. Dead: OO#..  Playing
Research Engineer (Solar/BatteriesO.O#.   #.O#.  with
/Software/Embedded Controllers)   .OO#.   .OO#.  rocks...1k
---
Sent from my phone. Please excuse my brevity.

On May 24, 2014 5:57:58 AM PDT, Juan Ulises Bohorquez Carvajal 
juan.bohorq...@ecopetrol.com.co wrote:
Hello, I work in the area of ������Geomatics in  Ecopetrol,  
Ecopetrol
is an Oil  GAS company with 10,000 employees. The licensing of R
allows me to use it in production at my company or academic use only?
Sincerely,


JB.


Este mensaje y sus anexos est�� dirigido para ser usado por su(s)
destinatario(s) exclusivamente y puede contener informaci��n
confidencial y/o reservada protegida legalmente. Si usted no es el
destinatario, se le notifica que cualquier distribuci��n o
reproducci��n del mismo, o de cualquiera de sus anexos, est��
estrictamente prohibida. Si usted ha recibido este mensaje por error,
por favor notif��quenos inmediatamente y elimine su texto original,
incluidos los anexos, o destruya cualquier reproducci��n del mismo. Las
opiniones expresadas en este mensaje son responsabilidad exclusiva de
quien las emite y no necesariamente reflejan la posici��n institucional
de Ecopetrol S.A. ni comprometen la responsabilidad institucional por
el uso que el destinatario haga de las mismas. Este mensaje ha sido
verificado con software antivirus. En consecuencia, Ecopetrol S.A. no
se hace responsable por la presencia en ��l, o en sus anexos, de alg��n
virus que pueda generar da��os en los equipos o programas del
destinatario.

This e-mail, and any attachments thereto, is intended for use by the
addressee(s) named herein only and may contain legally privileged
and/or confidential information. If you are not the recipient of this
e-mail, you are hereby notified that any distribution or copying of
this e-mail, and any attachments thereto, is strictly prohibited. If
you have received this e-mail in error, please notify us immediately,
permanently delete the original including attachments, and destroy any
copy or printout thereof. The opinions contained in this message are
the sole responsibility of the individual person who gives them and do
not either necessarily reflect the institutional policy of Ecopetrol
S.A. on the subject, or involve corporate responsibility for any use of
them by the addressee(s). This message has been checked with antivirus
software; therefore, Ecopetrol S.A. is not liable for the presence of
any virus in the message or in its attachments that causes or may cause
damage to the recipient's equipment or software.


   [[alternative HTML version deleted]]





__
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide
http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.



Este mensaje y sus anexos está dirigido para ser usado por su(s) 
destinatario(s) exclusivamente y puede contener información confidencial y/o 
reservada protegida legalmente. Si usted no es el destinatario, se le notifica 
que cualquier distribución o reproducción del mismo, o de cualquiera de sus 
anexos, está estrictamente prohibida. Si usted ha recibido este mensaje por 
error, por favor notifíquenos inmediatamente y elimine su texto original, 
incluidos los anexos, o destruya cualquier reproducción del mismo. Las 
opiniones expresadas en este mensaje son

Re: [R] R License

2014-05-24 Thread Juan Ulises Bohorquez Carvajal
Thanks, could you send to me an official certificate in pdf with this 
information? Or a certified email to support the information license?


Best regards,


Jb


 Mensaje original 
De: John Kane
Fecha:24/05/2014 10:04 AM (GMT-05:00)
A: Juan Ulises Bohorquez Carvajal ,r-help@R-project.org
Asunto: RE: [R] R License

It is an Open Source program and can be used by anyone.

John Kane
Kingston ON Canada


 -Original Message-
 From: juan.bohorq...@ecopetrol.com.co
 Sent: Sat, 24 May 2014 07:57:58 -0500
 To: r-help@r-project.org
 Subject: [R] R License

 Hello, I work in the area of b??b??Geomatics in  Ecopetrol,  Ecopetrol is
 an Oil  GAS company with 10,000 employees. The licensing of R allows me
 to use it in production at my company or academic use only?
 Sincerely,


 JB.


FREE 3D MARINE AQUARIUM SCREENSAVER - Watch dolphins, sharks  orcas on your 
desktop!





Este mensaje y sus anexos est? dirigido para ser usado por su(s) 
destinatario(s) exclusivamente y puede contener informaci?n confidencial y/o 
reservada protegida legalmente. Si usted no es el destinatario, se le notifica 
que cualquier distribuci?n o reproducci?n del mismo, o de cualquiera de sus 
anexos, est? estrictamente prohibida. Si usted ha recibido este mensaje por 
error, por favor notif?quenos inmediatamente y elimine su texto original, 
incluidos los anexos, o destruya cualquier reproducci?n del mismo. Las 
opiniones expresadas en este mensaje son responsabilidad exclusiva de quien las 
emite y no necesariamente reflejan la posici?n institucional de Ecopetrol S.A. 
ni comprometen la responsabilidad institucional por el uso que el destinatario 
haga de las mismas. Este mensaje ha sido verificado con software antivirus. En 
consecuencia, Ecopetrol S.A. no se hace responsable por la presencia en ?l, o 
en sus anexos, de alg?n virus que pueda generar da?os en los equipos o progr!
 amas del destinatario.

This e-mail, and any attachments thereto, is intended for use by the 
addressee(s) named herein only and may contain legally privileged and/or 
confidential information. If you are not the recipient of this e-mail, you are 
hereby notified that any distribution or copying of this e-mail, and any 
attachments thereto, is strictly prohibited. If you have received this e-mail 
in error, please notify us immediately, permanently delete the original 
including attachments, and destroy any copy or printout thereof. The opinions 
contained in this message are the sole responsibility of the individual person 
who gives them and do not either necessarily reflect the institutional policy 
of Ecopetrol S.A. on the subject, or involve corporate responsibility for any 
use of them by the addressee(s). This message has been checked with antivirus 
software; therefore, Ecopetrol S.A. is not liable for the presence of any virus 
in the message or in its attachments that causes or may cause damage to th!
 e recipient's equipment or software.


[[alternative HTML version deleted]]

__
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.


Re: [R] R License

2014-05-24 Thread Juan Ulises Bohorquez Carvajal
Thanks for your information


Jb


 Mensaje original 
De: John Kane
Fecha:24/05/2014 10:33 AM (GMT-05:00)
A: Timothy W. Cook ,Juan Ulises Bohorquez Carvajal
CC: r-help@R-project.org
Asunto: Re: [R] R License

Aha, someone knowledeable has shown up. Thanks Tim

John Kane
Kingston ON Canada


 -Original Message-
 From: t...@mlhim.org
 Sent: Sat, 24 May 2014 12:23:10 -0300
 To: juan.bohorq...@ecopetrol.com.co
 Subject: Re: [R] R License

 On Sat, May 24, 2014 at 9:57 AM, Juan Ulises Bohorquez Carvajal 
 juan.bohorq...@ecopetrol.com.co wrote:

 Hello, I work in the area of b??b??Geomatics in  Ecopetrol,  Ecopetrol
 is an
 Oil  GAS company with 10,000 employees. The licensing of R allows me to
 use it in production at my company or academic use only?
 Sincerely,



 'R' like many open source applications, uses several licenses because it
 includes several other open source components.  If you are concerned
 about
 using R for commercial purposes or in a commercial environment then you
 (or
 your attorney/legal dept.) should consult

 http://www.r-project.org/Licenses/

 The intent is for to to be available free, for wide use.  But no one else
 knows your intended use case.

 Cheers,
 Tim



 
 Timothy Cook
 LinkedIn Profile:http://www.linkedin.com/in/timothywaynecook
 MLHIM http://www.mlhim.org

[[alternative HTML version deleted]]

 __
 R-help@r-project.org mailing list
 https://stat.ethz.ch/mailman/listinfo/r-help
 PLEASE do read the posting guide
 http://www.R-project.org/posting-guide.html
 and provide commented, minimal, self-contained, reproducible code.


FREE ONLINE PHOTOSHARING - Share your photos online with your friends and 
family!
Visit http://www.inbox.com/photosharing to find out more!




Este mensaje y sus anexos est? dirigido para ser usado por su(s) 
destinatario(s) exclusivamente y puede contener informaci?n confidencial y/o 
reservada protegida legalmente. Si usted no es el destinatario, se le notifica 
que cualquier distribuci?n o reproducci?n del mismo, o de cualquiera de sus 
anexos, est? estrictamente prohibida. Si usted ha recibido este mensaje por 
error, por favor notif?quenos inmediatamente y elimine su texto original, 
incluidos los anexos, o destruya cualquier reproducci?n del mismo. Las 
opiniones expresadas en este mensaje son responsabilidad exclusiva de quien las 
emite y no necesariamente reflejan la posici?n institucional de Ecopetrol S.A. 
ni comprometen la responsabilidad institucional por el uso que el destinatario 
haga de las mismas. Este mensaje ha sido verificado con software antivirus. En 
consecuencia, Ecopetrol S.A. no se hace responsable por la presencia en ?l, o 
en sus anexos, de alg?n virus que pueda generar da?os en los equipos o progr!
 amas del destinatario.

This e-mail, and any attachments thereto, is intended for use by the 
addressee(s) named herein only and may contain legally privileged and/or 
confidential information. If you are not the recipient of this e-mail, you are 
hereby notified that any distribution or copying of this e-mail, and any 
attachments thereto, is strictly prohibited. If you have received this e-mail 
in error, please notify us immediately, permanently delete the original 
including attachments, and destroy any copy or printout thereof. The opinions 
contained in this message are the sole responsibility of the individual person 
who gives them and do not either necessarily reflect the institutional policy 
of Ecopetrol S.A. on the subject, or involve corporate responsibility for any 
use of them by the addressee(s). This message has been checked with antivirus 
software; therefore, Ecopetrol S.A. is not liable for the presence of any virus 
in the message or in its attachments that causes or may cause damage to th!
 e recipient's equipment or software.


[[alternative HTML version deleted]]

__
R-help@r-project.org mailing list
https://stat.ethz.ch/mailman/listinfo/r-help
PLEASE do read the posting guide http://www.R-project.org/posting-guide.html
and provide commented, minimal, self-contained, reproducible code.