Documentation

[thomthom]

Maybe we should add to the method documentation what version the methods are compatible with? Maybe adding a comment line in the code as well. I'm thinking just looking at the SU API docs and checking the methods we use instead of actually testing each method.

[Chris Fullmer]

I think thats not bad, but maybe we should only use major releases. At this point, we're still developing a first release. Seems like that is only important once you add new features to a 2nd public release.

[thomthom]

I was thinking of indicating what SU versions our methods require.

[Chris Fullmer]

Ahh, gotcha! that didn't cross my mind. At this point I haven't worked on anything that is incompatible with any versions. Makes sense.

Chris

[Jim]

What version of SketchUp did the Ruby API first ship with? 4? I know version 5 had it - that's when I started with it.

The current API makes no mention of anything before version 6, though.

I have been wading through the RDoc documentation is hopes finding a clue on how to write a custom output generator to output Google Code wiki syntax from rdoc. I am not any closer to understanding it than I was a week ago. I am now looking at a document generator called yard (which is RDoc compatible) that is better documented than RDoc.

But I agree, if a library methods relies on a certain version of the API, then it needs to be documented.

[thomthom]

I think it's 4.
But that's why struck me, the API docs only dates back to SU6.

[Chris Fullmer]

I have not pulled the wiki files to see what they look like. Are they just text? or html files? I use RDoc for all my scripts (though I'm not really testing to see how great it comes out in Rdoc, and I don't document my methods like I should for RDoc). But it seems like there should be a way to make rdoc output into a good format for the wiki.

Maybe I'll pull the wiki repo and check it out too. If not rdoc, yard sounds promising then. Anything would be good.

Have you looked into the Google wiki docs to see if they recommend a method?

Chris

[Chris Fullmer]

Or we could write our own Ruby Script parser and implement our own ruby markup system so we can format it how we want. Hehehe, since none of us have anything else to work on

[thomthom]

Work + CityGen + Skx + Doublecut + Beta testing + Architectural competition + real life + summer + Custom RDoc parser..?