Re: About website, docs etc.

On 17/02/2010 11:29, Daniele Varrazzo wrote:
> Hello,
> 
> the last couple of week has been full of events: license change, new
> documentation, and if you haven't noticed yet, the homepage at
> http://initd.org/ is no more unwelcoming as it has been in the last
> couple of years (well, in case you miss it, the rant is still
> reachable at /down.html...)

Eh eh.

> Well, the homepage is not in a 2.0 bells and whistles style. ...it
> also looks suspiciously similar to the documentation... but you know,
> once you have an hammer...

You did a great work and everything's fine. We'll move some more
projects to initd.org in the future and the homepage will probably go
back to its original, pre-2k layout. But right now it is *perfect*.

> - Which are the critical informations missing from the webpage? Or
> also less critical but you'd like to see addressed?

I leave this one to psycopg's users.

> - I'd say we definitely need a FAQ section where to provide direct
> solution to the gotchas a new user may find. I am not exactly a
> newcomer so I may start filling it but I would surely need an hand
> getting back in a newcomer's shoes. Can you help me to find the "right
> questions"? Somebody has mentioned a previously existing FAQ: is it
> still available/useful?

Not very much. I'd like to have the FAQ in rst format in the original
distribution, if it is possible.

> - For the previous point, probably a collaborative area would be the
> best tool. Probably nobody of us is willing to set up a complete wiki
> and start fighting the spam, so I'd say we could borrow a page from
> Python's or PG's wiki and write it there. They have recently set up
> http://wiki.postgresql.org/wiki/Psycopg : we may fill a FAQ section
> here. What do you think?

I agree but see above. I think having all documentation togheter with
the source code is a big plus and makes easy the work of packages.

[snip of pizza and mandolino]

> If you'd like to contribute material to the website or to the
> documentation, once in a lifetime I feel saying just give me/us the
> idea and I'll be glad to add it (I do because I know there is not much
> work left after all). But, in case you feel like writing a page, or a
> css, or fixing something, you can grab everything from the branches
> "website" and "docs" on http://piro.develer.com/psycopg2.git and shout
> when you have something to pull (gitweb is here [1] if you want to
> peek).

Is the website branch very different from the python2 branch? If they
diverged too much maybe it is better to setup a different repository
else I'd like to fold it into the original branch.

federico

-- 
Federico Di Gregorio                                       fog-NGVKUo/i/[email protected]
 A desobediência é uma virtude necessária à criatividade. -- Raul Seixas

_______________________________________________
Psycopg mailing list
Psycopg-IAPFreCvJWPBWskQ1e/[email protected]
http://lists.initd.org/mailman/listinfo/psycopg

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iEYEARECAAYFAkt7x9IACgkQvcCgrgZGjeuyFACgl+LJWc/AR+0sLzsvV6gOfqkh
W7MAoM6T26yo0maBAO9cNUftV8Pdd6ji
=yF63
-----END PGP SIGNATURE-----