Hello,
continuing my efforts to update old and obsolete php.net sites, now I
would like to present my proposal of changes to doc.php.net. As I can
miss some important things, any feedback is appreciated.
Currently I don't have VCS access, so I will still sending my changes as
PRs but my account request is awaiting for answer so I hope that in
about week it may changed. Anyway, I would like to counsult following ideas:
1) First of all, IMO interface of this site is quite complicated. In top
menu user have to choose from dozens of flags, then choose one of four
projects (ommiting "all"). Then shows the contextual menu on the right
which is different depending on page.
I have noticed that many elements are identical across all projects and
languages. In example: "PhD" and "Documentation Howto". So in my opinion
those links should be placed in top menu but not as typical project
becouse they doesn't require language variants.
2) As far as I can see http://doc.php.net/[project]/users.php or
http://doc.php.net/[project]/[lang]/users.php doesn't work independ of
context. Maybe this element could be removed to simplify service a little?
3) Back to interface: I thought and Hannes also suggested me integrating
doc.php.net with web-shared. As it means totally new design we have to
discuss how to make it easy to understand and to use.
My conteption is to place three links to projecs in top menu: PHP, PEAR
and PHP-GTK. Besides them links to "PhD" and "Documentation HowTo" but
they should be standalone pages as I said above.
So, user first chooses project and then he has to choose a language. I
think this order is proper becouse probably not all projects have all
language variants, right?
4) Quite major idea but... do we really need to translate everything
into mother languages of contributors? I think that we can assume that
people who want to contribute to original english doc or want to
translate doc... know English. Introducing this change should make
everything easier to mantain and to keep up-to-date.
Any thoughts?
--
PHP Webmaster List Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
