Thread: Searchable 7.3.1 Documentation - now interactive!

Searchable 7.3.1 Documentation - now interactive!

From
"Greg Sabino Mullane"
Date:
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1


Work is coming along nicely on the new search engine for the
PostgreSQL 7.3.1 documentation. I've made many improvements,
thanks to the feedback from early testers, and am now ready
to try out the "interactive" part of the documentation.
Please take a look and try it out. If anyone wants to practice
being a "moderator" which lets you approve or deny user-supplied
idocs, let me know as well.


Postgres 7.3.1 Searchable Interactive Documentation:

http://www.gtsm.com/cgi/psearch

- --
Greg Sabino Mullane greg@turnstep.com
PGP Key: 0x14964AC8 200301241621

-----BEGIN PGP SIGNATURE-----
Comment: http://www.turnstep.com/pgp.html

iD8DBQE+Ma6fvJuQZxSWSsgRApUPAJ90+Ns2hOaMknpDIFYsGElqrq+AEgCgrrEC
paFqI1eaBUXbRCqShm1IJY0=
=wGV0
-----END PGP SIGNATURE-----



Re: Searchable 7.3.1 Documentation - now interactive!

From
Justin Clift
Date:
Hi Greg,

Dave Page has recently been re-vamping the Interactive Docs on the main
PostgreSQL website, and it looks like you've been working on the same
thing too.

Do you reckon it would be worthwhile your combining forces to see if the
best-possible-idocs can come out of it?

:-)

Regards and best wishes,

Justin Clift


Greg Sabino Mullane wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
>
> Work is coming along nicely on the new search engine for the
> PostgreSQL 7.3.1 documentation. I've made many improvements,
> thanks to the feedback from early testers, and am now ready
> to try out the "interactive" part of the documentation.
> Please take a look and try it out. If anyone wants to practice
> being a "moderator" which lets you approve or deny user-supplied
> idocs, let me know as well.
>
>
> Postgres 7.3.1 Searchable Interactive Documentation:
>
> http://www.gtsm.com/cgi/psearch
>
> - --
> Greg Sabino Mullane greg@turnstep.com
> PGP Key: 0x14964AC8 200301241621
>
> -----BEGIN PGP SIGNATURE-----
> Comment: http://www.turnstep.com/pgp.html
>
> iD8DBQE+Ma6fvJuQZxSWSsgRApUPAJ90+Ns2hOaMknpDIFYsGElqrq+AEgCgrrEC
> paFqI1eaBUXbRCqShm1IJY0=
> =wGV0
> -----END PGP SIGNATURE-----
>
>
>
> ---------------------------(end of broadcast)---------------------------
> TIP 5: Have you checked our extensive FAQ?
>
> http://www.postgresql.org/users-lounge/docs/faq.html


--
"My grandfather once told me that there are two kinds of people: those
who work and those who take the credit. He told me to try to be in the
first group; there was less competition there."
- Indira Gandhi


Re: Searchable 7.3.1 Documentation - now interactive!

From
Justin Clift
Date:
Dave Page wrote:
> Hi Justin,
>
> The new idocs are now complete bar one formatting bug to fix in the document storage code. The new search engine will
allowdecent boolean queries across all or select parts of the postgresql.org sites - this just needs a little work to
getfinished. 

Cool.  Looks like there will be searchable doc's all around then.

;-)

> The new documentation code is also designed to work with the site build code and mirror system as you know (though
currentlydisabled). 

Yep, good point.

> Whilst I appreciate Greg's efforts, having skived off work for 3 days to write the code, I have no intention of doing
itagain. I would suggest that future efforts are made known to the webmaster so we can make sure our efforts are
coordinated. 

Another good point.

Greg, your searchable docs are pretty cool, but it also looks like we've
been developing the official searchable docs at the same time too.

Oh well.

Regards and best wishes,

Justin Clift


> Regards, Dave.


--
"My grandfather once told me that there are two kinds of people: those
who work and those who take the credit. He told me to try to be in the
first group; there was less competition there."
- Indira Gandhi


Re: Searchable 7.3.1 Documentation - now interactive!

From
greg@turnstep.com
Date:
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1


On January 25, 2003, Dave Page wrote:
> Whilst I appreciate Greg's efforts, having skived off work for 3 days
> to write the code, I have no intention of doing it again. I would
> suggest that future efforts are made known to the webmaster so we
> can make sure our efforts are coordinated.

The door swings both ways. I announced my new version on January 16th
to the general list, in a clearly labeled subject line.

People have been complaining about the documentation for a long time,
and I thought it was time to, as a recent thread put it, "put up or
shut up." My goal is to turn our documentation from one of the worst
to one of the best. The major shortcoming of the docs has always been
the searching, so I focused my efforts there. I also am endeavoring to
build something more than just a Google search of the /idocs directory:
if we can't do better than that, we may as well just put in a Google
search form box. (which has been suggested by others).

I'd like to take a look at the new version of the idocs, but they still
appear to be down (as well as major parts of the website).


- --
Greg Sabino Mullane  greg@turnstep.com
PGP Key: 0x14964AC8 200301260920

-----BEGIN PGP SIGNATURE-----
Comment: http://www.turnstep.com/pgp.html

iD8DBQE+M2mNvJuQZxSWSsgRAt27AJ9G9uScmuNXKbojG27isEIQB7F2EQCbBH41
HeBImR3fXTO/pyIqoCobx7w=
=JLG+
-----END PGP SIGNATURE-----



Re: Searchable 7.3.1 Documentation - now interactive!

From
"Dave Page"
Date:
Hi Justin,

The new idocs are now complete bar one formatting bug to fix in the document storage code. The new search engine will
allowdecent boolean queries across all or select parts of the postgresql.org sites - this just needs a little work to
getfinished. 

The new documentation code is also designed to work with the site build code and mirror system as you know (though
currentlydisabled). 

Whilst I appreciate Greg's efforts, having skived off work for 3 days to write the code, I have no intention of doing
itagain. I would suggest that future efforts are made known to the webmaster so we can make sure our efforts are
coordinated. 

Regards, Dave.

_____________Original message ____________
Subject:    Re: [GENERAL] Searchable 7.3.1 Documentation - now interactive!
Sender:    "Justin Clift" <justin@postgresql.org>
Date:        Sat, 25 Jan 2003 09:22:26 +0000

Hi Greg,

Dave Page has recently been re-vamping the Interactive Docs on the main
PostgreSQL website, and it looks like you've been working on the same
thing too.

Do you reckon it would be worthwhile your combining forces to see if the
best-possible-idocs can come out of it?

:-)

Regards and best wishes,

Justin Clift


Greg Sabino Mullane wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
>
> Work is coming along nicely on the new search engine for the
> PostgreSQL 7.3.1 documentation. I've made many improvements,
> thanks to the feedback from early testers, and am now ready
> to try out the "interactive" part of the documentation.
> Please take a look and try it out. If anyone wants to practice
> being a "moderator" which lets you approve or deny user-supplied
> idocs, let me know as well.
>
>
> Postgres 7.3.1 Searchable Interactive Documentation:
>
> http://www.gtsm.com/cgi/psearch
>
> - --
> Greg Sabino Mullane greg@turnstep.com
> PGP Key: 0x14964AC8 200301241621
>
> -----BEGIN PGP SIGNATURE-----
> Comment: http://www.turnstep.com/pgp.html
>
> iD8DBQE+Ma6fvJuQZxSWSsgRApUPAJ90+Ns2hOaMknpDIFYsGElqrq+AEgCgrrEC
> paFqI1eaBUXbRCqShm1IJY0=
> =wGV0
> -----END PGP SIGNATURE-----
>
>
>
> ---------------------------(end of broadcast)---------------------------
> TIP 5: Have you checked our extensive FAQ?
>
> http://www.postgresql.org/users-lounge/docs/faq.html


--
"My grandfather once told me that there are two kinds of people: those
who work and those who take the credit. He told me to try to be in the
first group; there was less competition there."
- Indira Gandhi