user manual - planning dives

[Miika Turkia]

On Tue, Feb 19, 2013 at 3:55 AM, Dirk Hohndel <dirk at hohndel.org> wrote:
> Reinout Hoornweg <reinout at xs4all.nl> writes:
>
>> On Monday 18 February 2013 13:47:21 Dirk Hohndel wrote:
>>> Reinout Hoornweg <reinout at xs4all.nl> writes:
>>> >> Also, the created html file now references images/icons/warning.png
>>> >> which we don't appear to have...
>>> >
>>> > Ah, that's probably because I used the asciidoc's way of showing a
>>> > warning.
>>> > The 'make user-manual.xhtml' uses a2x which can create an images-directory
>>> > with the needed icons.
>>>
>>> The look and feel of the html created by that was strange. Tables are
>>> very narrow, for example. Can you explain the advantages to me?
>>
>> No particular advantage. Just a slightly different format that seemed more in
>> line with  the PDF-version and it copied the needed images. The makefile still
>> does the original rendering in html when doing "make show" or "make doc".
>
> OK
>
>>> > Makes the page look prettier and I think at some point we'll need an
>>> > images- directory anyway if we want to add screenshots to the
>>> > documentation.
>>> That's a good point. The documentation is utterly lacking images and
>>> that's a major shortcoming. Not sure we'll have time to address this
>>> time around (remember, I'm trying to release in just a few days), but
>>> definitely something to work on.
>>
>> Using screenshots would be nice, but that is a good goal to add to the list
>> for a next release. In the meantime I'll do some work on the tables included
>> in the documentation. I'll be adding headers, borders, etc. to make them look
>> a little bit nicer.

Here is a start for the screenshots. Should I go ahead and add a few
more of key pop-ups like downloading from DC? Or would it be better to
not have any until we can do a thorough job?

miika
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0001-Adding-screen-captures-of-dive-planning.patch
Type: application/octet-stream
Size: 108354 bytes
Desc: not available
URL: <http://lists.hohndel.org/pipermail/subsurface/attachments/20130219/d4e35cc8/attachment-0001.obj>