On Sun, Mar 16, 2014 at 2:28 AM, Maciej Sobaczewski <[email protected]>wrote:
> 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 > > I wasn't even aware anyone was still using doc.php.net for anything.
