Tutorials for phpDocumentor docBook
Moderator: General Moderators
- Ollie Saunders
- DevNet Master
- Posts: 3179
- Joined: Tue May 24, 2005 6:01 pm
- Location: UK
Tutorials for phpDocumentor docBook
Anybody written tutorials in phpDocumentor with docBook?
Know any good resources/tutorials/applications for doing it?
Know any good resources/tutorials/applications for doing it?
http://blog.casey-sweat.us/?p=25 is a little broader in scope than just the docbook stuff, but I think I remember touching on it a bit. You might also want to look at the files in SimpleTest as an example, I worked out a couple of things to generate the docs at http://simpletest.org/ (the lower right frame)
- Ollie Saunders
- DevNet Master
- Posts: 3179
- Joined: Tue May 24, 2005 6:01 pm
- Location: UK
- Ollie Saunders
- DevNet Master
- Posts: 3179
- Joined: Tue May 24, 2005 6:01 pm
- Location: UK
Yeah, we have to create them on the fly by transforming the XML sources so we can have one source for the text docs, lastcraft site and the docbook for the phpdoc sources. I have to head out right now, but when I get back I will get you the transformed versions and post them as a zip file here.
Thanks for the comments on the presentation, have not heard much feedback. Hard to go too much in depth in 30 minutes. I would like to do a longer tutorial sometime where you explore the API of a system using mocks.
Thanks for the comments on the presentation, have not heard much feedback. Hard to go too much in depth in 30 minutes. I would like to do a longer tutorial sometime where you explore the API of a system using mocks.
- Ollie Saunders
- DevNet Master
- Posts: 3179
- Joined: Tue May 24, 2005 6:01 pm
- Location: UK
Isn't that the whole point of docBook, that you can do that?Yeah, we have to create them on the fly by transforming the XML sources so we can have one source for the text docs, lastcraft site and the docbook for the phpdoc sources.
Sweet; thanks.I have to head out right now, but when I get back I will get you the transformed versions and post them as a zip file here.
Yeah I thought it was pretty courageous to start coding in a room full of programmers within sniping range. I suppose I would have liked to have seen a more advanced tutorial, the basics are really easy in my opinion, it's just a question of disciplining yourself to write the tests first. It's the more advanced areas of unit testing i'm interested in now like mocks, testing larger bodies of code, web testing or strategies for tackling legacy code.Thanks for the comments on the presentation, have not heard much feedback.
Here is one of the transformed doc sets. Not the most recent but should help. I believe there was some non-docbook stuff introduced (little Smarty macros) which would mess up the XSLT transformations to the other formats, hence the reason for pure XML sources.
Hmm. I don't see a file upload option. Try simpletest_phpdoc.tgz
Hmm. I don't see a file upload option. Try simpletest_phpdoc.tgz
- Ollie Saunders
- DevNet Master
- Posts: 3179
- Joined: Tue May 24, 2005 6:01 pm
- Location: UK