On Thu, Nov 29, 2012 at 8:12 AM, Brad Dewar <bde...@stfx.ca> wrote:
> Hi
>
> As of PHP 5.4.x, the SQLite3 extension has an undocumented method called 
> createCollation().
>
> I'd like to add it to the docs. I'm just reading through your 'how to submit 
> documentation' docs now for the first time.
>
> I added a new file en/reference/sqlite3/sqlite3/createcollation.xml in the 
> online editor.  I just copy-pasted sqlite3/createfunction.xml and made the 
> appropriate changes.
>
> The preview button doesn't work for it.  I assume (but don't know) there's no 
> preview because I can't commit to the real repository, and I'm not working on 
> a local copy.  Any tips on how to use the PDOE better?
>
> Even without the preview, I can guess that one issue with the page would be 
> that it doesn't have the "available since PHP 5.4" note on it.  How would I 
> add that?
>

Version information is maintained in special "versions.xml" files, for
sqlite3 it would be in en/reference/sqlite3/versions.xml

As for previewing a new file... It wouldn't surprise me that
functionality doesn't work, and that is mostly due to the fact the
actual build system behind the online editor simply doesn't know about
the file yet and therefore can't build it before its committed.

I'm not very skilled in using the online editor, but the best usecases
for it are minor fixes (such as grammar/typo etc) and translating.
For the english docs, and new documentations, it could be slightly
tricky since the editor needs to do a lot of shortcuts and guesses
about the system :]

I was under the impression though that the editor had all the
skeletons somewhere and you should have been able to create a new
method documentation from a special template file?


-Hannes

Reply via email to