Re: creating an FAQ

2015-02-02 Thread Dirk Hohndel
On Mon, Feb 02, 2015 at 06:15:38PM +0200, Miika Turkia wrote:
> I think we will need to modify the following question, at least the
> question warrants explanation of the standard case before the caveats:
> 
> Q: How can I load pictures and associate them with my dive?
> 
> Select the dives you want to load and associate the pictures with. Then
> right click on one of the selected dives and select "Load images" from the
> popup menu. This will bring in a file selection dialog where you can select
> one or multiple pictures. When the selection is done and you hit Open, you
> get a new dialog where you can shift the times of the images. This is
> described in more detail in our user manual.
> 
> If you are having trouble with loading the images, check that you have at
> least one of the following tags in the Exif headers DateTimeOriginal or
> DateTime. We take the time from these fields to detect if the image was
> shot during the dive or not. If the picture is edited, you should store the
> original Exif information on the new/edited image for it to be loaded
> properly.

Excellent. Much better. I edited the FAQ on the website accordingly.

And to make it easier to maintain this and to allow people to send patches
and to allow for translations... I'll add the FAQ to the sources.

To make my life easier I'll add them with markup (sorry), but this should
be fairly obvious how it works.

/D
___
subsurface mailing list
subsurface@subsurface-divelog.org
http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface


Re: creating an FAQ

2015-02-02 Thread Miika Turkia
I think we will need to modify the following question, at least the
question warrants explanation of the standard case before the caveats:

Q: How can I load pictures and associate them with my dive?

Select the dives you want to load and associate the pictures with. Then
right click on one of the selected dives and select "Load images" from the
popup menu. This will bring in a file selection dialog where you can select
one or multiple pictures. When the selection is done and you hit Open, you
get a new dialog where you can shift the times of the images. This is
described in more detail in our user manual.

If you are having trouble with loading the images, check that you have at
least one of the following tags in the Exif headers DateTimeOriginal or
DateTime. We take the time from these fields to detect if the image was
shot during the dive or not. If the picture is edited, you should store the
original Exif information on the new/edited image for it to be loaded
properly.
___
subsurface mailing list
subsurface@subsurface-divelog.org
http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface


Re: creating an FAQ

2015-02-02 Thread Davide DB
Once number of questions grows maybe it worths splitting them under
several categories
___
subsurface mailing list
subsurface@subsurface-divelog.org
http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface


Re: creating an FAQ

2015-02-01 Thread Miika Turkia
On Mon, Feb 2, 2015 at 8:28 AM, Dirk Hohndel  wrote:

> Miika,
>
> excellent, excellent input.
>
> I have added most of your questions. I rephrased some of them (so all the
> questions are actually, you know, questions) and also changed some of the
> answers. Please double check what I just posted…
> \
> > On Feb 1, 2015, at 9:56 PM, Miika Turkia  wrote:
> >
> > Q: Editing dive sites
>
> What would you want there as response?
>

All I know, we get this question a lot. The working way of adding
dive-sites manually should be described and we should also describe how
this works with the companion app (unless this is answered when talking
about the companion app on its own).


> > Insufficient privileges to open device
>
> Again, what would be a good response?


I am thinking about the dialout group and udev rules on Linux.

miika
___
subsurface mailing list
subsurface@subsurface-divelog.org
http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface


Re: creating an FAQ

2015-02-01 Thread Benjamin
On 2 Feb 2015 08:28, "Dirk Hohndel"  wrote:
>
> Miika,
>
> excellent, excellent input.
>
> I have added most of your questions. I rephrased some of them (so all the
questions are actually, you know, questions) and also changed some of the
answers. Please double check what I just posted…
> \
> > On Feb 1, 2015, at 9:56 PM, Miika Turkia  wrote:
> >
> > Q: Editing dive sites
>
> What would you want there as response?
>
> > Insufficient privileges to open device
>
> Again, what would be a good response?
>
> /D
> ___
> subsurface mailing list
> subsurface@subsurface-divelog.org
> http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface

Maybe say what is done with the user input from the survey? For the privacy
fanatics out there... :)

Benjamin
___
subsurface mailing list
subsurface@subsurface-divelog.org
http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface


Re: creating an FAQ

2015-02-01 Thread Dirk Hohndel
Miika,

excellent, excellent input.

I have added most of your questions. I rephrased some of them (so all the 
questions are actually, you know, questions) and also changed some of the 
answers. Please double check what I just posted…
\
> On Feb 1, 2015, at 9:56 PM, Miika Turkia  wrote:
> 
> Q: Editing dive sites

What would you want there as response?

> Insufficient privileges to open device

Again, what would be a good response?

/D
___
subsurface mailing list
subsurface@subsurface-divelog.org
http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface


Re: creating an FAQ

2015-02-01 Thread Miika Turkia
On Mon, Feb 2, 2015 at 12:49 AM, Davide DB  wrote:

> On Sun, Feb 1, 2015 at 10:45 PM, Dirk Hohndel  wrote:
> >
> >
> > Thanks for the ZERO contributions. That really makes me excited to spend
> > my time on Subsurface.
> >
> > In the meantime I put up an initial FAQ on the website. If you have ideas
> > what should be added, or would like to propose a better answer, please
> let
> > me know.
>

Q: Why is Subsurface not able to download my dives?

Clean the contacts! Clean the contacts again! Check with other software
that the download works in general. Try another cable. See our user manual
for pairing with BT and the general use case.

Q: Why Subsurface freezes on import/export?

Depending on the amount of data, converting the log to the desired
output/input might take a looong time. Unfortunately the import currently
seems to freeze the UI for this duration. The export is done on a different
thread and it is most likely running in the back ground with no hint on
when it is complete :(

Q: Why is the CSV import failing

The CSV import has a couple of caveats. You should avoid some special
characters
like ampersand (&), less than (<), greater than (>) and double quotes ("),
the latter if quoting text cells. The
file should use UTF-8 character set, if having non-ASCII characters. Also
the
size of the CSV file might cause problems. Importing 100 dives at a time
(without dive profile) has worked previously, but larger files might exceed
limits of the parser used. When having problems with CSV imports, try first
with
a smaller sample to make sure everything works.

Q: Editing dive sites

Q: Multiuser usage

Store logs of different users to separate log files. From Subsurface, you
can open individual files for different divers and multiple users is
supported quite well.

Loading pictures

We are currently looking for fields named DateTimeOriginal and DateTime
from the Exif header and use those to detect if the image was shot
during the dive or not. If the picture is edited, you should store the
original Exif information on the new/edited image for it to be loaded
properly.

Insufficient privileges to open device

My old log software is not supported for import

If your old log software supports exporting the log book, we might well be
able to import that. However, usually a native support for importing that
format will give more complete information into Subsurface.To implement
support for the log format, we will need a sample log file. It would be
great to have also a screenshot from the original log software or
description of the dive that is shown on the sample log. Preferably we
would like to have a reasonably simple dive to get basic support and
another dive that has as many features enabled as possible (e.g. gas
changes during the dive). This information should be sent to the developer
mailing list subsurface@subsurface-divelog.org (but e.g. user forum can be
used as well). Unfortunately some of the log formats we have not been able
to decipher, so there are no guarantees that this will bring support for
your old log software, but it is worth a try.

My dive computer is not supported

miika
___
subsurface mailing list
subsurface@subsurface-divelog.org
http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface


Re: creating an FAQ

2015-02-01 Thread Davide DB
On Sun, Feb 1, 2015 at 10:45 PM, Dirk Hohndel  wrote:
>
>
> Thanks for the ZERO contributions. That really makes me excited to spend
> my time on Subsurface.
>
> In the meantime I put up an initial FAQ on the website. If you have ideas
> what should be added, or would like to propose a better answer, please let
> me know.
>

Life comes first :)

Q1: How much does it cost my passion? (do not let see this feature to
your partner)

With to the gas consumption stats I discovered I saved 1000 EURO of gas in
less of one year (66 dives) with my pSCR.
Thanks to Anton and Thanks to Subsurface!


Q2: Can I log dives with multiple tanks with the same gas in
subsurface? In other words can I use Subsurface for serious cave or
tech diving?

Description on how to add tanks, mix and gas switches... (Actually I
thought I would write a Subsurface survival guide for tech divers)

Q3: Logging dives is boring and life is short; how Subsurface could help me?


Bye

-- 
Davide
https://vimeo.com/bocio/videos
___
subsurface mailing list
subsurface@subsurface-divelog.org
http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface


Re: creating an FAQ

2015-02-01 Thread Dirk Hohndel

> On Jan 30, 2015, at 10:03 AM, Dirk Hohndel  wrote:
> 
> We need a user focused FAQ. In addition to the manual.
> 
> Questions like "I added a dive on the companion app but don't see it in
> Subsurface". I'll add this to the website but need help collecting some of
> the questions.
> 
> If you have a question you think should be added, please send as reply to
> this email. Don't worry about phrasing, don't worry if you don't know the
> full answer. It's easy to clean this up. It's quite hard to collect the
> questions (I kinda know how all this works - it's the people who aren't as
> deeply inside of the code that have the questions...)
> 
> So this is a great opportunity for the 150 or so non-developers on this
> list to contribute!

Thanks for the ZERO contributions. That really makes me excited to spend
my time on Subsurface.

In the meantime I put up an initial FAQ on the website. If you have ideas
what should be added, or would like to propose a better answer, please let 
me know.

/D
___
subsurface mailing list
subsurface@subsurface-divelog.org
http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface


creating an FAQ

2015-01-30 Thread Dirk Hohndel
We need a user focused FAQ. In addition to the manual.

Questions like "I added a dive on the companion app but don't see it in
Subsurface". I'll add this to the website but need help collecting some of
the questions.

If you have a question you think should be added, please send as reply to
this email. Don't worry about phrasing, don't worry if you don't know the
full answer. It's easy to clean this up. It's quite hard to collect the
questions (I kinda know how all this works - it's the people who aren't as
deeply inside of the code that have the questions...)

So this is a great opportunity for the 150 or so non-developers on this
list to contribute!

Thanks

/D
___
subsurface mailing list
subsurface@subsurface-divelog.org
http://lists.subsurface-divelog.org/cgi-bin/mailman/listinfo/subsurface