When you use borb
, you’re trusting us with your information.
We understand this is a big responsibility and work hard to protect your information and put you in control.
This Privacy Policy is meant to help you understand what information we collect, why we collect it, and how you can update, manage, export, and delete your information.
When you use borb
, you are (by default) sending anonymous usage information to one of our servers.
borb
sends information upon creating and upon reading a PDF (although this may change in future releases).
These are roughly the steps followed:
- Upon installing
borb
, a random user ID is generated - This user ID is stored in the installation directory of
borb
(assuming the right file-permissions, etc) - Whenever a read/write operation is performed,
borb
sends the following data:- anonymous_user_id (A randomly generated ID, associated with your user/installation of
borb
) - event (The action that triggered sending statistics, this could be
PDF::loads
orPDF::dumps
) - number_of_pages (the number of pages read/written)
- sys_platform (which operating system you are using
borb
on) - utc_time_in_ms
- version (which version of
borb
you are using)
- anonymous_user_id (A randomly generated ID, associated with your user/installation of
Note: In order to determine your location (city, country_code, country_name, latitude, longitude, state) a free online API is used
We use this data to ensure our services are top-quality.
For instance, knowing which versions of borb
are currently in use enables to decide which versions to continue to support.
Similarly, we may also decide to invest extra developer-time in supporting arabic scripts should we see a market in this.
And then there is the big split of investing effort into the "reading PDF documents" versus "writing PDF documents" code.
This is yet another example of where having user data helps.
By being able to measure specific usages of borb
(e.g. "reading a PDF", "writing a PDF", etc) we are able to determine where to invest
developer-time. This in turn improves your experience with borb
as we are continually orienting ourselves to the user-demands.
By knowing our customers, we may develop new products and services that are tailored towards a specific market.
By knowing the amount of PDF documents created/read with each version, we can get idea of the popularity and adoption rate of each version of borb
.
This gives us the opportunity to fine-tune our release-cycle.
We want to ensure developer-effort is spent on those issues that impact the most users. In order to ensure this, we need to know how many people are using
a given version of borb
.
You can disable the gathering of anonymous usage statistics, all you need to do is call UsageStatistics.disable()
.
This in turn will call AnonymousUserID.disable()
which will replace the file (containing your user ID) with a 0 byte file.
This is the signal to the rest of borb
not to send the usage statistics anymore.
Should you so desire, you can (re-) enable them by calling UsageStatistics.enable()
.