On Mon, Jan 26, 2009 at 12:36 PM, Eric Wilhelm <[email protected]>wrote:
> As far as I'm concerned, my svn is "published". The holdup re: turning > it on itself is only that I've yet to get any input from others on what > sort of documentation it needs to be usable. > > http://scratchcomputing.com/svn/CPDK/trunk > I think it needs a cookbook, to start. And probably the main CPDK module needs to have 'getting started' guide, by topic (e.g. "starting a new distribution" and "publishing a new distribution"). It's just not clear what the hell I do with it. Make a config file of some sort, right? What do I put into it? Why one thing or another? Do I have to hand-generate it? Or can I autogenerate a default? Just listing the API with so little detail isn't really that helpful. I think you need to give examples of usage for each one, both programmatically and as it would be used in the config file. Will it work on any distribution, even ones I didn't create with CPDK? Or is there something specific about the way CPDK lays out files that I need to know about? (E.g. Changes have version + date on line 3). Does it support git? And -- FWIW, the requirements in Build.PL seem to be missing stuff. What the heck is VCfs? -- David
