Re: Conversion text in documentation

Hi David!

On Thu, 28 Oct 2021 22:02:43 -0700
David Christensen <[email protected]> wrote:

> On 10/25/21 12:41 PM, Andrea Tosoni wrote:
> > Hello,
> >=20
>=20
> Contributing to a FOSS project can be an exciting learning experience.  :=
-)
>=20
>=20
> You will want to create a distribution that the various Perl and CPAN=20
> tools can understand.  "Writing Perl Modules for CPAN" by Sam Tregar was=
=20
> helpful back in the day:
>=20
> https://link.springer.com/book/10.1007/978-1-4302-1152-5
>=20

do note https://perl-begin.org/topics/cpan/#preparing-dists which supersede=
d it.

>=20
> I have always used ExtUtils::MakeMaker and h2xs(1) to create Perl=20
> distributions:
>=20
> https://man.archlinux.org/man/core/perl/h2xs.1perl.en
>=20
>=20
> Git seems to be the current, popular choice for version control.  I use C=
VS.
>=20
>=20
> GitHub seems to be the current, popular choice for collaboration and=20
> support.  I will need to convert to Git to utilize GitHub.
>=20
>=20
> That's the fun stuff.  Then there's the not-so-fun stuff -- legal.=20
> Notably, intellectual property (IP) and data privacy.  You do not want=20
> to make a mistake here.
>=20
>=20
> You will need to select a license.  For Perl, the Artistic License is=20
> traditional.  But, there are examples of CPAN distributions with other=20
> licenses.  Note that "Public Domain" can be problematic.  h2xs(1)=20
> provides a POD license section in the main module that indirectly refers=
=20
> to the Artistic License.  To be pedantic, include a LICENSE file in the=20
> root of your distribution.  See:
>=20
> https://opensource.org/licenses
>=20
> https://opensource.org/licenses/Artistic-2.0
>=20

See
https://www.shlomifish.org/philosophy/computers/open-source/foss-licences-w=
ars/rev2/#which-licence-same-as-perl
.

>=20
> Do you have sole and complete ownership of everything you plan to=20
> release?  More directly:  do you have the legal right to release the=20
> software?
>=20
>=20
> In the USA, where I reside, any document I create -- software, data,=20
> this e-mail message, etc. -- is automatically copyrighted.  But if I=20
> wish to defend my copyright, I would be wise to submit a copy and file a=
=20
> copyright application with the United States Patent and Trademark Office=
=20
> (USPTO).
>=20
>=20
> You mentioned your software in the context of a company.  In the USA, if=
=20
> I conceive, create, use, improve, etc., content in an employment or=20
> consulting arrangement without a contract stating otherwise, then my=20
> employer or client gains rights to all or part of that content.  This is=
=20
> called the "work for hire" principle.
>=20
>=20
> Have you signed any contracts with your employer related to IP and/or=20
> data privacy, such as a Confidential Disclosure Agreement, a=20
> Non-Disclosure Agreement, an Intellectual Property Assignment Agreement,=
=20
> etc.?  Does your employer have any written policies regarding IP and/or=20
> data privacy?
>=20
>=20
> Have you reviewed the license for FrameMaker?
>=20
>=20
> If others helped you with the software, or if you used their ideas=20
> and/or content, then they could have a stake in the software.
>=20
>=20
> Regarding data privacy, be aware of the Health Insurance Portability and=
=20
> Accountability Act (HIPPA) (USA), the EU Charter of Fundamental Rights,=20
> and whatever laws apply in your country.
>=20
>=20
> What is your strategy for liability of content within the release --=20
> e.g. unauthorized use of copyrighted content, unauthorized use of=20
> patented processes, improper reverse engineering, etc.?  Even if=20
> everything is okay today, new patents, etc., may create violations in=20
> the future.  Have you heard of "patent trolls"?
>=20
>=20
> You should discuss this with your employer.  You or they may wish to=20
> consult an attorney or legal service.
>=20
>=20
> David



--=20

Shlomi Fish       https://www.shlomifish.org/
https://www.shlomifish.org/lecture/C-and-CPP/bad-elements/

Ariana Grande has one less problem *with* Chuck Norris.
    =E2=80=94 https://www.shlomifish.org/humour/bits/facts/Chuck-Norris/

Please reply to list if it's a mailing list post - https://shlom.in/reply .