Merge in old support site FAQs

Author: addshore

.vitepress/config.mts

@@ -32,6 +32,21 @@ const protocolMenuItems = Object.keys(protocolGroups)
     };
   });
 
+// Ability to generate other collections of side bar entries
+const sidebarItemsFromDir = (dir) => {
+  const files = fs.readdirSync(dir)
+  return files
+    .filter(file => file !== 'index.md')
+    .map(file => {
+      const name = file.replace('.md', '')
+      const displayName = name.charAt(0).toUpperCase() + name.slice(1).replace(/-/g, ' ');
+      return {
+        text: displayName,
+        link: `${dir}/${name}`
+      }
+    })
+}
+
 const sidebarSpec1 = useSidebar({ spec: loadSpec(1) });
 const sidebarSpec2 = useSidebar({ spec: loadSpec(2) });
 
@@ -101,7 +116,6 @@ export default defineConfig({
   themeConfig: {
     // https://vitepress.dev/reference/default-theme-config
     nav: [
-      { text: 'Home', link: '/' },
       {
         text: 'Hardware',
         items: [
@@ -126,10 +140,6 @@ export default defineConfig({
       },
       { text: 'On Premise', link: '/onprem/' },
       { text: 'Guides', link: '/guides/' },
-      {
-        text: 'Terminology',
-        link: '/basics/index.html',
-      },
       {
         text: 'Company',
         items: [
@@ -140,26 +150,41 @@ export default defineConfig({
       }
     ],
     sidebar: {
-      '/basics': [
+      '/terminology': [
+        {
+          text: 'FAQ',
+          link: '/faq/',
+        },
         {
-          text: 'Basics',
-          link: '/basics/',
+          text: 'Terminology',
+          link: '/terminology/',
           items: [
             {
               text: 'General',
               items: [
-                { text: 'IoT', link: '/basics/iot' },
-                { text: 'Positioning', link: '/basics/positioning' },
-                { text: 'Observability', link: '/basics/observability' },
+                { text: 'IoT', link: '/terminology/iot' },
+                { text: 'Positioning', link: '/terminology/positioning' },
+                { text: 'Observability', link: '/terminology/observability' },
               ]
             },
-            { text: 'Devices', link: '/basics/devices' },
-            { text: 'Points', link: '/basics/points' },
-            { text: 'Readings', link: '/basics/readings' },
-            { text: 'Billing', link: '/basics/billing' },
+            { text: 'Devices', link: '/terminology/devices' },
+            { text: 'Points', link: '/terminology/points' },
+            { text: 'Readings', link: '/terminology/readings' },
+            { text: 'Billing', link: '/terminology/billing' },
           ],
         },
       ],
+      '/faq': [
+        {
+          text: 'FAQ',
+          link: '/faq/',
+          items: sidebarItemsFromDir(path.resolve(__dirname, '../faq')),
+        },
+        {
+          text: 'Terminology',
+          link: '/terminology/',
+        }
+      ],
       '/devices': [
         {
           text: 'Devices',

.vitepress/theme/Layout.vue

@@ -10,6 +10,8 @@ const { go } = useRouter()
 
 const redirects = Object.entries({
   '/silos': '/onprem',
+  '/terminology': '/terminology',
+  '/guides/troubleshooting': '/faq/troubleshooting',
 })
 
 watch(

apis/v1/glossary.md

@@ -12,7 +12,7 @@ The version 1 API uses a number of terms that may not be familiar to all users.
 
 ## Points
 
-General information about points can be found [in the basics section](/basics/points.html).
+General information about points can be found [in the basics section](/terminology/points.html).
 
 ### sendReason
 

apps/admin/devices.md

@@ -51,7 +51,7 @@ You can toggle `Info` and `Status` from this list using the buttons.
 
 #### Latest Points
 
-Shows some of the most recent [points](/basics/points.html) for the device.
+Shows some of the most recent [points](/terminology/points.html) for the device.
 
 ![](https://i.imgur.com/K7Js6XF.png)
 

basics/index.md

@@ -0,0 +1,24 @@
+---
+aside: false
+---
+# Account
+
+[[toc]]
+
+## How can I add multiple Lightbug devices to my account?
+
+There is no limit to the number of trackers you can have associated to a single account.
+
+You can always add a new device in the Lightbug portal, on the [account page](https://lightbug.cloud/#/devices/settings/subscription) by [following the documented instructions](/apps/cloud/device-settings/subscription-account#add-a-new-device).
+
+## Can multiple accounts track a single tracker?
+
+It may be that you use your Lightbug GPS tracker for tracking a vehicle, and there are multiple users of the vehicle that all want to monitor it.
+
+If you [contact us](https://lightbug.io/contact/) we can share trackers between accounts, so that multiple users can track the same device.
+
+## Can I change the email address of my account?
+
+If you need to change your email address after creating your Lightbug account, you need to [contact our support team](https://lightbug.io/contact/) and we will change it for you.
+
+It is not possible for you to update this information on the any of our portals.

faq/account.md

@@ -0,0 +1,44 @@
+---
+aside: false
+---
+# Connectivity
+
+[[toc]]
+
+## Do the devices have Bluetooth connectivity?
+
+Yes, at the time of writing all of our core devices have Bluetooth connectivity
+
+This enables features like short range location searching, mobile safe-zone and remote controlled alarm to help you find it.
+
+Be sure to check the [individual device pages](/devices) for the most up-to-date information.
+
+## Do the devices need internet to work?
+
+Each device works by sending information via the internet.
+Our SIM cards can roam across many networks in different countries and will pick the network with the strongest signal, rather than being tied to a single operator.
+Our devices do not work so well in remote areas with little/no cell coverage, as they need the internet to connect.
+
+Unlike many GPS trackers, our devices have their own internet connection.
+
+They do not rely on Bluetooth or being near a mobile phone.
+
+## Will the devices work in remote/poor signal area?
+
+Lightbug devices do not work so well in remote areas with little to no cell coverage, as they need the internet to connect.
+
+Luckily, with over 600 network partners globally, this is a rare occurrence!
+
+## Will the device work indoors?
+
+Our trackers work both indoors and outdoors.
+
+They use [GPS/GNSS](/terminology/positioning#gnss-global-navigation-satellite-system) to locate themselves outdoors and [WPS (WiFi Positioning System)](/terminology/positioning#wifi-positioning) when indoors.
+
+Typical accuracy outdoors is 1-5m, and 10-30m indoors.
+
+If you need better accuracy indoors, [get in touch](https://lightbug.io/contact/)!
+
+## Which countries do LightBug products work in?
+
+Lightbug devices feature [worldwide coverage](https://lightbug.io/feature/worldwide-coverage/).

faq/connectivity.md

@@ -0,0 +1,91 @@
+---
+aside: false
+---
+# Devices
+
+[[toc]]
+
+## Can the devices be turned off?
+
+There is no physical on/off button on any of our trackers, but you can disable the device through the [Lightbug App](/apps/cloud/).
+
+If you no longer need the device, you can cancel your subscription at any time and reactivate devices at a later date.
+
+There are other forms of control accessible via APIs, such as the ability to lock the device in sleep mode for up to 24 hours, which will temporarily disable location updates when moving. Or the ability to put a device in deep sleep, there is will need to be put on charge or button pressed to wake it up.
+
+## How long will the battery last? ![](https://i.imgur.com/107HL9y.png){width=100 style="float:right"}
+
+The battery life of the device depends on your required settings.
+
+The best way to find out the estimated battery life is to use our [battery life calculator](https://lightbug.io/) on our website.
+
+## Can the devices operate in extreme weather conditions?
+
+Generally the devices have an operating temperature of -20°C to 60°C (device specific operating temperatures are available on the dedicated device webpages). In both the extremely higher and lower temperatures the battery life of the trackers may be affected.
+
+We do have devices operating in the Middle East.
+
+We can supply Lightbug Pros with a -55°C to 65°C operational range, [let us know](https://lightbug.io/contact/) if you would like more information about these devices.
+
+## Are the devices waterproof?
+
+Check the device specifications on the [dedicated device pages](/devices) for the IP rating of the device.
+
+## Does Lightbug install the devices?
+
+No, we do not install devices.
+
+Some devices, such as the vehicle tracker, have [dedicated installation guides](/devices/vehicle/installation).
+
+Should you have any questions on installation and mounting, we're happy to help!
+
+## Will the devices work straight out of the box?
+
+The devices arrive **ready to use**, there is no assembly required; however, you will need to charge and activate your tracker.
+
+You'll possibly find the [adding my first device guide](/guides/adding-your-first-device) useful if this is your first time using a Lightbug device.
+
+## What comes in the box? ![](https://i.imgur.com/CaCDdWV.png){width=220 style="float:right"}
+
+The contents of the box will vary depending on the device you have ordered.
+
+The shop includes all information on what is bundled with the various SKUs.
+
+Such as the page for the [Pro](https://lightbug.io/product/lb-dev-pr2/) which at the time of writing includes the Pro device, a charge dock, USB cable and one month of data.
+
+## Are you able to produce custom devices?
+
+Yes we can, we love being surprised by the new and innovative uses for our tracking technology!
+
+So, if our devices don’t exactly fit your requirements, get in touch and we’ll see what we can do.
+
+See [the custom devices page](/devices/custom) for more information.
+
+## How often will I have to replace a Lightbug device?
+
+Unless there is accidental damage, you should not need to replace your Lightbug GPS tracker.
+
+If your device has a manufacturing defect within the first three years, it is likely covered under warranty, please [contact us](https://lightbug.io/contact/), as this differs per device and manufacture date.
+
+## Where is the best place to mount devices?
+
+It depends on your use case.
+
+However, please do not fully surround the tracker with metal as it blocks the signals.
+
+Below are some recommendations for best performance, if none of the suggestions work well for you, get in touch with details of your use case.
+
+Some suggestions:
+ - People: a bag, shoes, outside pocket, keys, lanyard
+ - Assets: face the device upwards with a clear line of sight to the sky
+ - Vehicle: glove compartment, under the seat, underside of the vehicle (magnetic LightBug Pro)
+
+## Do the trackers need to be exposed?
+
+Our trackers do not need to be fully exposed; however, they do not work well when fully surrounded by metal as this blocks the signals.
+
+## How strong is the Pro magnetic mount?
+
+The magnet is powerful with a pull force of 70lb / 32kg.
+
+It will securely mount the Lightbug Pro to the underside of a moving vehicle.

faq/devices.md

@@ -0,0 +1,5 @@
+# FAQ
+
+This FAQ (Frequently Asked Questions) is created from the most common questions we receive from our customers.
+
+If you have a question that is not answered here, please [contact us](https://lightbug.io/contact/).

faq/index.md

@@ -0,0 +1,30 @@
+---
+aside: false
+---
+# Privacy
+
+[[toc]]
+
+## What privacy measures are in place?
+
+All data is encrypted in transit: from the moment a signal is transmitted by the device to the moment you view it.
+
+We also adhere to all EU General Data Protection Regulation (GDPR).
+
+Your data cannot be viewed by anyone else and we will never look at your data (unless you ask us to for support).
+
+Your data will never be sold or used for any purpose other than providing the service you signed up for.
+
+Please [contact us](https://lightbug.io/contact/) if you have any questions about privacy.
+
+## If someone finds the tracker can they trace it back to me?
+
+If your tracker falls into the wrong hands there is no way they can find out who owns it.
+
+Similarly there is no way they can re-purpose the tracker and use it for themselves or view historical data.
+
+Please note that our devices are designed to allow you to track your own property and that in many countries it is illegal to track someone else or their property without explicit consent.
+
+Please refer to local regulations before using LightBug devices.
+
+We will co-operate with authorities and where illegal use has been identified, provide evidence which may be used for prosecution.

faq/privacy.md

@@ -0,0 +1,52 @@
+---
+aside: false
+---
+# Shipping
+
+[[toc]]
+
+## Do you ship internationally?
+
+Yes, we ship to most countries!
+
+Shipping costs and times will be shown during checkout.
+
+## How fast can I get my devices?
+
+For all items in stock, we aim to dispatch your order within 1-3 days. Shipping times will vary.
+
+Dispatch time: It can take 1-3 days for your order to be processed, packaged and collected by the courier from our office.
+
+Shipping time: Shipping times will be shown at checkout after you enter your address. This is approximately how long it will take for your order to arrive once it has collected by the courier from our office.
+
+## Will I have to pay customs or import fees?
+
+We will prepare all the required documentation for international shipping, however Lightbug does not take responsibility for any customs or import fees that may occur once your order reaches its destination country, the customer must cover these charges.
+
+We have very little control over these charges, and cannot accurately tell you how much these would be as they vary widely from country to country.
+
+If you have any queries regarding possible customs and fees, we recommend reaching out to your local customs office.
+
+## My order is on hold at customs, what should I do?
+
+If your order is on hold at customs please contact your local customs office or shipping courier.
+
+If you're still facing problems, [reach out to us](https://lightbug.io/contact/).
+
+## What if my country isn't listed at checkout
+
+If your country isn't listed at checkout, please [contact us](https://lightbug.io/contact/) and we'll see what we can do.
+
+## Can I change my shipping address after placing the order ?
+
+Our shipping team may have already started processing your order, however, we may be able to amend your shipping address before dispatch.
+
+Please [get in touch](https://lightbug.io/contact/) with us as soon as possible if you need to change your shipping address.
+
+## I haven't received my order or shipping confirmation?
+
+It may be that your confirmation emails have gone to your spam or junk mail so we recommend that you check there first.
+
+If you still cannot find your confirmation, it may be that we have an incorrect email address for you.
+
+Please [contact us](https://lightbug.io/contact/) with the full name the order was placed under.