public inbox for [email protected]  
help / color / mirror / Atom feed
techdocs beta testing
4+ messages / 3 participants
[nested] [flat]

* techdocs beta testing
@ 2006-04-19 01:31 Guido Barosio <[email protected]>
  2006-04-19 01:37 ` Re: techdocs beta testing Guido Barosio <[email protected]>
  2006-04-22 02:20 ` Re: techdocs beta testing Robert Treat <[email protected]>
  0 siblings, 2 replies; 4+ messages in thread

From: Guido Barosio @ 2006-04-19 01:31 UTC (permalink / raw)
  To: pgsql-www

A quick run over the new techdocs site shows:

<404 errors>

 * http://www.postgresql.org/docs/techdocs.3

	"A Visual Basic utility to convert Dbase III, IV, and V" ->
http://www.postgresql.org/source/migration.zip

 * http://www.postgresql.org/docs/techdocs.26

	The reference to the "authors website" is wrong (404)

 * http://www.postgresql.org/docs/techdocs.3

	While calling the following links:

	-"Porting Horror Story" ->
http://www.frankhilliard.com/horrorstory.cfm  the connection timed out
with no success at all.
	-"PostgreSQL and Microsoft Access" -> http://www.scw.org/pgaccess/ which  (404)


<Weird behaviours>

 * http://www.postgresql.org/docs/techdocs.3

	- Directory listing instead of documentation, tho it's not clear or
maybe needs a review:

	Conversion tool for migrating from MySQL to PostgreSQL by PostgreSQL Inc.

	- Oracle Section

	While calling: orapgsqlviews project at gborg
(http://gborg.postgresql.org/project/orapgsqlviews/projdisplay.php)
there gborg site
	reports that something went wrong, no project was specified  or an
invalid project was specified.


<Missing tags or work to be done>

- <a name> tags missing in:

http://www.postgresql.org/docs/techdocs.25

Tried to correct this, but the html editor complains when
I hit the save button.

the idea is to add the ....

<a name=one>
<a name=two>
<a name=three>
<a name=four>

.... tags to the objects therefore named in the content.


<add ons>

- added wikipedia as a technical reference in:

http://www.postgresql.org/docs/techdocs.2

Wikipedia related article: Related articles, comunity managed.
(or alike, just an idea)

(But couldn't check the preview, why?)

< ambiguous  >

The techdocs.33 page seems to just a mid step between the original link in the
techdocs.4 page, and is just presenting a link to a pdf file, while in
other cases, we directly call the pdf files, tho.


< about >

I will walk again through the site, and try to spot other issues.
A formal QA document will be posted then to this list.

Would be great to understand why after saving some modifications I
wasn't allowed to get the preview. Prolly just late and my brain
working less than usual.

Regards,
Guido

--
Guido Barosio
-----------------------
http://www.globant.com
[email protected]



^ permalink  raw  reply  [nested|flat] 4+ messages in thread

* Re: techdocs beta testing
  2006-04-19 01:31 techdocs beta testing Guido Barosio <[email protected]>
@ 2006-04-19 01:37 ` Guido Barosio <[email protected]>
  1 sibling, 0 replies; 4+ messages in thread

From: Guido Barosio @ 2006-04-19 01:37 UTC (permalink / raw)
  To: pgsql-www

note that I would take out those broken links from the docs, but the
save && preview method didn't work, or got me confused, so I will wait
to understand how it works (or if Robert's mail bout diff is related
with this).

Rgds.
G.-

On 4/19/06, Guido Barosio <[email protected]> wrote:
> A quick run over the new techdocs site shows:
>
> <404 errors>
>
>  * http://www.postgresql.org/docs/techdocs.3
>
>         "A Visual Basic utility to convert Dbase III, IV, and V" ->
> http://www.postgresql.org/source/migration.zip
>
>  * http://www.postgresql.org/docs/techdocs.26
>
>         The reference to the "authors website" is wrong (404)
>
>  * http://www.postgresql.org/docs/techdocs.3
>
>         While calling the following links:
>
>         -"Porting Horror Story" ->
> http://www.frankhilliard.com/horrorstory.cfm  the connection timed out
> with no success at all.
>         -"PostgreSQL and Microsoft Access" -> http://www.scw.org/pgaccess/ which  (404)
>
>
> <Weird behaviours>
>
>  * http://www.postgresql.org/docs/techdocs.3
>
>         - Directory listing instead of documentation, tho it's not clear or
> maybe needs a review:
>
>         Conversion tool for migrating from MySQL to PostgreSQL by PostgreSQL Inc.
>
>         - Oracle Section
>
>         While calling: orapgsqlviews project at gborg
> (http://gborg.postgresql.org/project/orapgsqlviews/projdisplay.php)
> there gborg site
>         reports that something went wrong, no project was specified  or an
> invalid project was specified.
>
>
> <Missing tags or work to be done>
>
> - <a name> tags missing in:
>
> http://www.postgresql.org/docs/techdocs.25
>
> Tried to correct this, but the html editor complains when
> I hit the save button.
>
> the idea is to add the ....
>
> <a name=one>
> <a name=two>
> <a name=three>
> <a name=four>
>
> .... tags to the objects therefore named in the content.
>
>
> <add ons>
>
> - added wikipedia as a technical reference in:
>
> http://www.postgresql.org/docs/techdocs.2
>
> Wikipedia related article: Related articles, comunity managed.
> (or alike, just an idea)
>
> (But couldn't check the preview, why?)
>
> < ambiguous  >
>
> The techdocs.33 page seems to just a mid step between the original link in the
> techdocs.4 page, and is just presenting a link to a pdf file, while in
> other cases, we directly call the pdf files, tho.
>
>
> < about >
>
> I will walk again through the site, and try to spot other issues.
> A formal QA document will be posted then to this list.
>
> Would be great to understand why after saving some modifications I
> wasn't allowed to get the preview. Prolly just late and my brain
> working less than usual.
>
> Regards,
> Guido
>
> --
> Guido Barosio
> -----------------------
> http://www.globant.com
> [email protected]
>


--
Guido Barosio
-----------------------
http://www.globant.com
[email protected]



^ permalink  raw  reply  [nested|flat] 4+ messages in thread

* Re: techdocs beta testing
  2006-04-19 01:31 techdocs beta testing Guido Barosio <[email protected]>
@ 2006-04-22 02:20 ` Robert Treat <[email protected]>
  1 sibling, 0 replies; 4+ messages in thread

From: Robert Treat @ 2006-04-22 02:20 UTC (permalink / raw)
  To: pgsql-www; +Cc: Guido Barosio <[email protected]>

On Tuesday 18 April 2006 21:31, Guido Barosio wrote:
> A quick run over the new techdocs site shows:
>
> <404 errors>
>
>  * http://www.postgresql.org/docs/techdocs.3
>
> 	"A Visual Basic utility to convert Dbase III, IV, and V" ->
> http://www.postgresql.org/source/migration.zip
>

must have missed this one, but downloaded it fom techdocs, uploaded to www, 
and updated link

>  * http://www.postgresql.org/docs/techdocs.26
>
> 	The reference to the "authors website" is wrong (404)
>

I've sent an email to the author; if anyone can find the missing link we could 
update it. (i didnt check google cache or the internet archive, could start 
there)

>  * http://www.postgresql.org/docs/techdocs.3
>
> 	While calling the following links:
>
> 	-"Porting Horror Story" ->
> http://www.frankhilliard.com/horrorstory.cfm  the connection timed out
> with no success at all.

works for me, maybe a temporary problem?

> 	-"PostgreSQL and Microsoft Access" -> http://www.scw.org/pgaccess/ which 
> (404)
>

I managed to find a version of this in the google cache. I've added it to the 
site and updated the link apropriatly. 
>
> <Weird behaviours>
>
>  * http://www.postgresql.org/docs/techdocs.3
>
> 	- Directory listing instead of documentation, tho it's not clear or
> maybe needs a review:

either i dont understand where your looking or it works for me. (this page has 
been updated a few times, so maybe that fixed it?)

>
> 	Conversion tool for migrating from MySQL to PostgreSQL by PostgreSQL Inc.
>
> 	- Oracle Section
>
> 	While calling: orapgsqlviews project at gborg
> (http://gborg.postgresql.org/project/orapgsqlviews/projdisplay.php)
> there gborg site
> 	reports that something went wrong, no project was specified  or an
> invalid project was specified.
>

the only thing i can find is an old announcement from chris browne back when 
he worked for great bridge.  seems a little mysterious as i am sure that 
project used to be there. I've dropped Chris an email about it. 

>
> <Missing tags or work to be done>
>
> - <a name> tags missing in:
>
> http://www.postgresql.org/docs/techdocs.25
>
> Tried to correct this, but the html editor complains when
> I hit the save button.
>
> the idea is to add the ....
>
> <a name=one>
> <a name=two>
> <a name=three>
> <a name=four>
>
> .... tags to the objects therefore named in the content.
>

Magnus, you initiall left out the name attribute for anchor tags, do you have 
any objections to allowing them?

>
> <add ons>
>
> - added wikipedia as a technical reference in:
>
> http://www.postgresql.org/docs/techdocs.2
>
> Wikipedia related article: Related articles, comunity managed.
> (or alike, just an idea)
>
> (But couldn't check the preview, why?)
>

did you save the change before trying to preview it?  did you get an error?

> < ambiguous  >
>
> The techdocs.33 page seems to just a mid step between the original link in
> the techdocs.4 page, and is just presenting a link to a pdf file, while in
> other cases, we directly call the pdf files, tho.
>

I think I followed the pattern of the intermediate page linking to the file in 
every case except the oscon slides/presentations page.  we probably should 
decide if that's our precedent or not. 

>
> < about >
>
> I will walk again through the site, and try to spot other issues.
> A formal QA document will be posted then to this list.
>
> Would be great to understand why after saving some modifications I
> wasn't allowed to get the preview. Prolly just late and my brain
> working less than usual.
>

The only thing that comes to mind is not saving the page before trying to 
preview it.  I am wondering if we ought to not have the preview button if the 
page hasnt been saved, since it is a little confusing. 

Another issue is I have seen a couple of people try to modify links to point 
to /community/techdocs.2112 or whatever instead of /docs/techdocs.2112  Is 
there something leading people to think the former is the proper link rather 
than the latter? 

Also a bug that I think exists is that after accepting Guido's changes to 
http://wwwmaster.postgresql.org/docs/techdocs.3 his name is not in the 
history, but mine is instead.  His name did show up in the admin interface 
though, to which i clicked edit and then made a few changes before accepting. 
istm his name should be in the history, but it isnt. 

thanks so much for the feedback so far!
-- 
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL




^ permalink  raw  reply  [nested|flat] 4+ messages in thread

* Re: techdocs beta testing
@ 2006-04-22 07:20 Magnus Hagander <[email protected]>
  0 siblings, 0 replies; 4+ messages in thread

From: Magnus Hagander @ 2006-04-22 07:20 UTC (permalink / raw)
  To: Robert Treat <[email protected]>; pgsql-www; +Cc: Guido Barosio <[email protected]>

> > <a name=one>
> > <a name=two>
> > <a name=three>
> > <a name=four>
> >
> > .... tags to the objects therefore named in the content.
> >
> 
> Magnus, you initiall left out the name attribute for anchor 
> tags, do you have 
> any objections to allowing them?

No. That was not intentional, so please go ahead and fix :-)

> > I will walk again through the site, and try to spot other issues.
> > A formal QA document will be posted then to this list.
> >
> > Would be great to understand why after saving some modifications I
> > wasn't allowed to get the preview. Prolly just late and my brain
> > working less than usual.
> >
> 
> The only thing that comes to mind is not saving the page 
> before trying to 
> preview it.  I am wondering if we ought to not have the 
> preview button if the 
> page hasnt been saved, since it is a little confusing. 

Would make sense to remove it,yeah.


> Another issue is I have seen a couple of people try to modify 
> links to point 
> to /community/techdocs.2112 or whatever instead of 
> /docs/techdocs.2112  Is 
> there something leading people to think the former is the 
> proper link rather 
> than the latter? 

The editpage lives in /community/docedit.2112 (on wwwmaster)


> Also a bug that I think exists is that after accepting 
> Guido's changes to 
> http://wwwmaster.postgresql.org/docs/techdocs.3 his name is 
> not in the 
> history, but mine is instead.  His name did show up in the 
> admin interface 
> though, to which i clicked edit and then made a few changes 
> before accepting. 
> istm his name should be in the history, but it isnt. 

Yes, I beleive the problem is that we "cut off" the first name in the
list. When the next person updates the page, Guido will suddenly show up
:)


//Magnus




^ permalink  raw  reply  [nested|flat] 4+ messages in thread


end of thread, other threads:[~2006-04-22 07:20 UTC | newest]

Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2006-04-19 01:31 techdocs beta testing Guido Barosio <[email protected]>
2006-04-19 01:37 ` Guido Barosio <[email protected]>
2006-04-22 02:20 ` Robert Treat <[email protected]>
2006-04-22 07:20 Re: techdocs beta testing Magnus Hagander <[email protected]>

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox