On 14 Apr 2008, at 11:01, Hannes Magnusson wrote:
On Mon, Apr 14, 2008 at 7:24 PM, Philip Olson <[EMAIL PROTECTED]>
wrote:
On 13 Apr 2008, at 15:05, Hannes Magnusson wrote:
Hi all
Attached is a patch refactoring context options into its own
reference
page under the language reference.
Pretty much only refactoring and new markup, almost no new content.
Hello Hannes-
I'm wondering if these should go within the extension docs
themselves (ex.
reference/curl/context.xml) or all together in one place. Why did
you choose
to put them all in one place?
Before the change they were scattered all around various chapters in
the appendix and extremely hard to navigate.
Because of that I doubt many people have used any of these features,
except for maybe the absolute basic http context options.
Furthermore we've had a bug report about the ssl options for good
period of time with seemingly noone even knowing where to document
them - so how would the user know where they are? :)
Since not many extensions define context options I think its better to
group them all together for a quick lookup and a better overview over
their usefulness.
Okay sounds reasonable, will you be adding links to them from the
appropriate extensions? I wonder if each context parameters
documentation should link to them too... hmm. Also, nice work
documenting this scary topic :)
Regards,
Philip
