Skip site navigation (1) Skip section navigation (2)

Re: Fixed warnings for Docs project

From: Dave Page <dpage(at)pgadmin(dot)org>
To: Akshay Joshi <akshay(dot)joshi(at)enterprisedb(dot)com>
Cc: pgadmin-hackers <pgadmin-hackers(at)postgresql(dot)org>
Subject: Re: Fixed warnings for Docs project
Date: 2012-05-09 14:37:55
Message-ID: CA+OCxowJuEZgLtCQj6pYW0xhetNZOcuK8Vyz0nzEymY8SzU7rw@mail.gmail.com (view raw or flat)
Thread:
Lists: pgadmin-hackers
Thanks.

I think we need to do some fine tuning here. There are a few issues:

- It looks like "search" is a reserved name. Sphinx creates a search
page in the HTML format docs with that name, so clicking on the link
to see how to search in pgAdmin takes you to the search form (does
that even work?). I guess the search.rst page needs renaming.

- The Appendices page needn't list the licences twice - it looks weird
in HTML, and far more bizarre in PDF format, where the pages in the
TOC get included inline.

- The MIT Kerberos Licence section shouldn't have "Kerberos Copyright"
as a sub-section on the Appendices page. That should only be a title
(maybe make it lower-level?) on the licence page itself.

- In PDF format, I see "Contents:" scattered around the doc. I assume
that's where there's a TOC, and the sub-page has been included inline
instead of the list of sub pages titles. It shouldn't be there - not
sure though if that's an issue with the way the TOCs have been
included in the ReST files, or a Sphinx issue.

Thanks.

On Wed, May 9, 2012 at 2:01 PM, Akshay Joshi
<akshay(dot)joshi(at)enterprisedb(dot)com> wrote:
> Modified search.png file attached.
>
>
> On Wed, May 9, 2012 at 6:26 PM, Akshay Joshi <akshay(dot)joshi(at)enterprisedb(dot)com>
> wrote:
>>
>> Wrong png file attached as I did git reset HEAD --hard. Wait will send new
>> image.
>>
>>
>> On Wed, May 9, 2012 at 6:24 PM, Akshay Joshi
>> <akshay(dot)joshi(at)enterprisedb(dot)com> wrote:
>>>
>>> Sorry, Attached.
>>>
>>>
>>> On Wed, May 9, 2012 at 5:35 PM, Dave Page <dpage(at)pgadmin(dot)org> wrote:
>>>>
>>>> EATTACHMENTMISSING :-)
>>>>
>>>> On Wed, May 9, 2012 at 1:00 PM, Akshay Joshi
>>>> <akshay(dot)joshi(at)enterprisedb(dot)com> wrote:
>>>> > Hi Dave
>>>> >
>>>> > I did following changes in Docs project
>>>> >
>>>> > Removed warnings during compilation of Docs project.
>>>> > Added missing default-xsl.rst and sample-xml.rst file.
>>>> > Added TOC tree.
>>>> > Modified search.png file. Attached with the mail.
>>>> >
>>>> > Attached is the patch file, please review it and if it looks OK to you
>>>> > then
>>>> > please commit it.
>>>> >
>>>> > --
>>>> > Akshay Joshi
>>>> > Senior Software Engineer
>>>> > EnterpriseDB Corporation
>>>> > The Enterprise PostgreSQL Company
>>>> > Phone: +91 20-3058-9522
>>>> > Mobile: +91 976-788-8246
>>>> >
>>>>
>>>>
>>>>
>>>> --
>>>> Dave Page
>>>> Blog: http://pgsnake.blogspot.com
>>>> Twitter: @pgsnake
>>>>
>>>> EnterpriseDB UK: http://www.enterprisedb.com
>>>> The Enterprise PostgreSQL Company
>>>
>>>
>>>
>>>
>>> --
>>> Akshay Joshi
>>> Senior Software Engineer
>>> EnterpriseDB Corporation
>>> The Enterprise PostgreSQL Company
>>> Phone: +91 20-3058-9522
>>> Mobile: +91 976-788-8246
>>>
>>
>>
>>
>> --
>> Akshay Joshi
>> Senior Software Engineer
>> EnterpriseDB Corporation
>> The Enterprise PostgreSQL Company
>> Phone: +91 20-3058-9522
>> Mobile: +91 976-788-8246
>>
>
>
>
> --
> Akshay Joshi
> Senior Software Engineer
> EnterpriseDB Corporation
> The Enterprise PostgreSQL Company
> Phone: +91 20-3058-9522
> Mobile: +91 976-788-8246
>



-- 
Dave Page
Blog: http://pgsnake.blogspot.com
Twitter: @pgsnake

EnterpriseDB UK: http://www.enterprisedb.com
The Enterprise PostgreSQL Company

Attachment: Screen Shot 2012-05-09 at 15.31.35.png
Description: image/png (56.1 KB) (inlined above)

In response to

Responses

pgadmin-hackers by date

Next:From: Dave PageDate: 2012-05-10 09:22:05
Subject: Bundling 1.16-beta1
Previous:From: Akshay JoshiDate: 2012-05-09 13:01:14
Subject: Re: Fixed warnings for Docs project

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group