Work so far:
* Split the (terrific) article bjori wrote out into a separate page.
* Move the notes for running the tests into a separate page and clean them up
to be a bit easier to follow.
Plans:
* Write a rough step-by-step guide to submitting a pull request — we have
information on the Wiki around merging a pull request, and information
scattered across the site on using Git, but nothing that really pulls it
together.
mega.
Feedback is definitely welcome on the documentation dropdown changes.
Squashed commit of the following:
commit 6c282d4558e77c2f9943db318691bef596e4fd4b
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 19:30:16 2012 +0800
Update the community links.
commit 82edf79fff4a500e3ca4a349b4c100e70d651f7e
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 19:12:38 2012 +0800
Move the calendar of events link under news to better balance the community
dropdown.
commit 809d2a9f6044db71a117453575a9882c5607d8a6
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 19:07:10 2012 +0800
Add a direct link to the manual TOC, and replace database with date/time in the
function reference, as that seems to be more commonly hit per Webalizer.
commit 73ca38258415f275a148fc8f74c91833eaf4ac71
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 18:55:44 2012 +0800
Attempt to cut the documentation mega dropdown... er, down.
At present, this is more than the height of my viewport on a MBP. This is
obviously a bad thing, and nobody in their right mind is ever going to read it.
I've cut it down to a maximum of one heading and five entries per column.
For the time being, I've tried to guess what the most hit and important pages
are in the manual, but hopefully we can get some metrics on this before the
beta site is launched and adjust accordingly.
Part of this also improves the markup we're generating on both the stable and
beta sites by removing the inline styles that have crept into
shared-manual.inc.
Squashed commit of the following:
commit 8aaaea73f8a1128c45bbd081b0a61fb58aaff10e
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 18:21:51 2012 +0800
Remove inline styles from the user note voting elements.
commit 4239bdcfa8506d5e37d678032570aa6b81fe54be
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 18:21:25 2012 +0800
Fix clearing behaviour when the user note heading wraps.
commit fc08e0abad0d1b500d0d1561bf5966febd3c4426
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 18:15:05 2012 +0800
Replace the user note vote styling on the beta site with something more inline
with the beta site style.
commit ade84bf601be20c74493d54d089edf8578ba1185
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 18:14:46 2012 +0800
Improve note vote support on the beta site.
commit 0e1a71f8a4945408000428fa88f1d5aa12aeeca4
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 18:12:31 2012 +0800
Add genanchors to user notes.
commit 03393d70a6f3ac8530432ba5d7c228528ad6230d
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 17:49:41 2012 +0800
Make the note styling more in line with other block elements by moving the
header row outside the shaded note body.
commit dc2a83990c33fd3cf7df209201536458ff01de59
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 17:45:10 2012 +0800
Rationalise beta site user note styles.
commit da2b492c186d6b8946170e1702f052ef93696028
Author: Adam Harvey <aharvey@php.net>
Date: Thu Dec 27 17:31:53 2012 +0800
Apply styling to user note dates in site.css, not inline.
We already have an override for paragraphs, but it makes sense to cover lists
as well, and it's needed for the new MySQL deprecation blocks on the function
reference pages, particularly since the beta site already handles this.