[wp-docs] Re: [wp-hackers] Codex function page proposal

[Jacob Santos]

Well, like I said, If you get it started, then I'll join in and walk 
beside you on your journey to achieving enlightenment. I would rather 
join in once I have time and I can contribute something that would only 
take a few hours or so a week. I'd be happy to add a few examples and 
improve the details, but that would mean that the page already exists.

Your script will hopefully carefully update the existing codex pages and 
not replace everything. The examples should always be applicable, unless 
there is a regression or the specs change.

Good luck.

Jacob Santos

Charles K. Clarkson wrote:
> Hello,
>
> I sent a copy of this message to the WP-Hackers list for reference. 
> Let's keep further discussion on the Documentation list, please.
>
> Thank you.
>
>
> Jacob Santos wrote:
>
> > You should have mentioned the Perl automated script.
>
> It started as a simple script with a few dozen lines that only I would
> ever use to skip over common sections in the Codex and blossomed into a
> multi-file, thousand line behemoth one long weekend. I didn't want to
> disclose it in its current condition. It's pretty slim on documentation.
> I did send Chris Jean a copy of it, however.
>
>
> > Hmm, it seems that whatever you conclude on, it will be interesting.
> > Hopefully, the conclusion will be sooner rather than later, because I
> > don't think any one else will attempt what you guys are doing at the
> > moment or at least not in the near future.
>
> == Function Pages Planning ==
>
> I just read the December Archives on the Hackers list. It looks like
> there is some interest there by real life programmers and hackers who
> are more familiar with the WordPress code and PHP than I am. Together we
> should be able to come up with an easy to update version of the codex on
> both a sample site and in the Codex Function Reference.
>
> Hopefully we will use the inline documentation you started as our
> starting point and provide updates for it as we move forward.
>
>
> == Function Pages Progress ==
>
> I intend to continue adding new function reference pages to the Codex
> while we discuss implementation of future Codex Function Reference
> pages. I'd like to see something up on the Codex rather than nothing
> until we sort out the details. So, the planning phase shouldn't hold up
> the action phase. We will just have to do some back-tracking later on.
>
> I added about 82 new function pages in December. I hope to add more in
> January. Wish us luck and perseverance. We'll need both.
>
>
> Have A Happy New Year,
>
> Charles Clarkson