You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@qpid.apache.org by Marnie McCormack <ma...@googlemail.com> on 2010/08/27 17:16:10 UTC

Documentation - Google hits

Hi,

I'm wondering if anyone on the list can shed list on why the details
contained in the new docbook format doesn't come back on the front page of
Google search results - where the wiki previously did.

For example, information on the Qpid Java FAQ comes back from cwiki but not
from the docbook (try Google for 'port broker uses at runtime' and you'll
see what I mean).

Is there something we need/ought to do to get the docbook stuff further up
the index ?

Thanks,
Marnie

RE: Documentation - Google hits

Posted by Robbie Gemmell <ro...@gmail.com>.
I just meant that many of the docbook pages (mostly Java related) aren't
complete and we don't link to them as prominently, which won't help their
chance of being ranked similarly. We also probably aren't helping their
cause by having both possible results in the first place.

We don't link directly to the converted FAQ page from the website menu for
instance, we link to the wiki export. To get to the docbook based FAQ you
have to go through the html or pdf links on the documentation page. The wiki
exported FAQ page has TOC heading based internal links to all the answers
which also probably aids its chances in the results. The docbook html export
currently has pages with filenames based on chapter and section numbers
rather than contextual name, making links to them (of which I doubt there
are [m]any) contain less information (qpid-java-faq.html vs ch01s02.html in
this specific case). 

These kind of things will contribute to differing results (searching for
'qpid port broker uses at runtime' for example gives a different result and
has the java docbook pdf as the top hit, with the old wiki export
3rd...whereas with just 'port broker uses at runtime' the pdf is on page 2
of results). We can surely improve the situation by finishing the docbook
off and optimising links and page filenames etc with search engines in mind,
it will just require time.

Robbie

> -----Original Message-----
> From: Marnie McCormack [mailto:marnie.mccormack@googlemail.com]
> Sent: 27 August 2010 18:41
> To: dev@qpid.apache.org
> Subject: Re: Documentation - Google hits
> 
> Do you mean this is item specific - it seemed to me from other searches
> that
> only the top level strings come back in the first searches and that
> text in
> the docbook pages doesn't score highly ?
> 
> Thanks,
> Marnie
> 
> On Fri, Aug 27, 2010 at 5:20 PM, Robbie Gemmell
> <ro...@gmail.com>wrote:
> 
> > Basically it just still needs finished, and only once its more
> > prominent on the website (the FAQ links still point to the wiki
> > export) will it start being favoured for search results.
> >
> > Robbie
> >
> > On 27 August 2010 16:16, Marnie McCormack
> >  <ma...@googlemail.com> wrote:
> > > Hi,
> > >
> > > I'm wondering if anyone on the list can shed list on why the
> details
> > > contained in the new docbook format doesn't come back on the front
> page
> > of
> > > Google search results - where the wiki previously did.
> > >
> > > For example, information on the Qpid Java FAQ comes back from cwiki
> but
> > not
> > > from the docbook (try Google for 'port broker uses at runtime' and
> you'll
> > > see what I mean).
> > >
> > > Is there something we need/ought to do to get the docbook stuff
> further
> > up
> > > the index ?
> > >
> > > Thanks,
> > > Marnie
> > >
> >
> > ---------------------------------------------------------------------
> > Apache Qpid - AMQP Messaging Implementation
> > Project:      http://qpid.apache.org
> > Use/Interact: mailto:dev-subscribe@qpid.apache.org
> >
> >


---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:dev-subscribe@qpid.apache.org


Re: Documentation - Google hits

Posted by Marnie McCormack <ma...@googlemail.com>.
Do you mean this is item specific - it seemed to me from other searches that
only the top level strings come back in the first searches and that text in
the docbook pages doesn't score highly ?

Thanks,
Marnie

On Fri, Aug 27, 2010 at 5:20 PM, Robbie Gemmell <ro...@gmail.com>wrote:

> Basically it just still needs finished, and only once its more
> prominent on the website (the FAQ links still point to the wiki
> export) will it start being favoured for search results.
>
> Robbie
>
> On 27 August 2010 16:16, Marnie McCormack
>  <ma...@googlemail.com> wrote:
> > Hi,
> >
> > I'm wondering if anyone on the list can shed list on why the details
> > contained in the new docbook format doesn't come back on the front page
> of
> > Google search results - where the wiki previously did.
> >
> > For example, information on the Qpid Java FAQ comes back from cwiki but
> not
> > from the docbook (try Google for 'port broker uses at runtime' and you'll
> > see what I mean).
> >
> > Is there something we need/ought to do to get the docbook stuff further
> up
> > the index ?
> >
> > Thanks,
> > Marnie
> >
>
> ---------------------------------------------------------------------
> Apache Qpid - AMQP Messaging Implementation
> Project:      http://qpid.apache.org
> Use/Interact: mailto:dev-subscribe@qpid.apache.org
>
>

Re: Documentation - Google hits

Posted by Robbie Gemmell <ro...@gmail.com>.
Basically it just still needs finished, and only once its more
prominent on the website (the FAQ links still point to the wiki
export) will it start being favoured for search results.

Robbie

On 27 August 2010 16:16, Marnie McCormack
<ma...@googlemail.com> wrote:
> Hi,
>
> I'm wondering if anyone on the list can shed list on why the details
> contained in the new docbook format doesn't come back on the front page of
> Google search results - where the wiki previously did.
>
> For example, information on the Qpid Java FAQ comes back from cwiki but not
> from the docbook (try Google for 'port broker uses at runtime' and you'll
> see what I mean).
>
> Is there something we need/ought to do to get the docbook stuff further up
> the index ?
>
> Thanks,
> Marnie
>

---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:dev-subscribe@qpid.apache.org


Re: Documentation - Google hits

Posted by Andrew Kennedy <an...@gmail.com>.
On 27 Aug 2010, at 16:16, Marnie McCormack wrote:
> Hi,
>
> I'm wondering if anyone on the list can shed list on why the details
> contained in the new docbook format doesn't come back on the front  
> page of
> Google search results - where the wiki previously did.
>
> For example, information on the Qpid Java FAQ comes back from cwiki  
> but not
> from the docbook (try Google for 'port broker uses at runtime' and  
> you'll
> see what I mean).
>
> Is there something we need/ought to do to get the docbook stuff  
> further up
> the index ?
>
> Thanks,
> Marnie

As I understand it, The Google has decided that the network of  
external (pre-existing) links, from people's blogs, other sites like  
stackoverflow.com and so forth, contribute highly to a pages  
'PageRank'. These will all still point at our old page names, so that  
is what The Google shows you. We need to publicise the changes, and  
make sure people link to the new pages.

Of course, if you add "+filetype:pdf" to your query it improves  
things somewhat; compare the results for "qpid java faq" with and  
without it...

Andrew.
-- 
-- andrew d kennedy ? do not fold, bend, spindle, or mutilate ;
-- http://grkvlt.blogspot.com/ ? edinburgh : +44 7941 197 134 ;


---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:dev-subscribe@qpid.apache.org