I think it sounds like a very good idea indeed, and I am sure IDA will see it similarly (will see Uwe tomorrow about other things, and be sure to bring up the suggestion).
(Feel very free to cut off the quoting of past messages hanging from the end of the message; the exporter will do it automagically on the lyskom side of the thread but you are much invited not to mimic. :-)
/ Johan Sundström (achtung xmas!)
Previous text:
2003-12-21 20:33: Subject: Re: More conference items: book and mailing list
Obviously, that makes sense. Is there any plan to release them under a "license" that might allow someone to print copies for others? I have no interest in attribution or compensation for work I have not done; but it sure would be nice to be able to say to someone, "look, here's the ISBN of a nice tutorial on the language". I think that with a bit of work, and some expansion in key areas, the tutorial could make a good "beginner's book". Getting it published is the easy part; but you have to have a manuscript first.
What say you, IDA, is there any interest in having this happen? I'd be glad to do the leg work on the tutorial, separate from my own efforts concerning the "reference manual".
Another rather pie in the sky idea that ran across my head was this: if IDA agreed to release the tutorial so that I could get it published in book form, we (a rather amorphous term admittedly) could put any potential proceeds in a big "pot" from which to fund particular projects, as a sort of incentive... you'd only need to sell a handful of books to be able to offer a USD/EUR100 bounty on say, better documentation for the Calendar module.
Wow, am i even covering advocacy today? Where's Martin Baehr??? :)
Any thoughts?
Bill
On Sunday, December 21, 2003, at 01:55 PM, Johan Sundström (achtung xmas!) @ Pike (-) developers forum wrote:
The entire pike docs (and copyrights) are owned and copyrighted to IDA just as is the rest of Pike.
(Which, by the way, is not a way of saying "Hands off!" but rather "Oh joy, we won't be having any pesky fights about Mine and Theirs!" later on. All who have been around here for a while knows the mess this will spare us... :-)
/ Johan Sundström (achtung xmas!)
Previous text:
2003-12-21 17:40: Subject: More conference items: book and mailing list
Hi All,
[apologies in advance for the cross-posting, i wasn't sure of the coverage on both lists]
I've been going through some of the items from the conference, and I thought I'd take a little initiative. To that end, here's an update:
- A pike book
I've decided to start work on Pike book. My target is somewhere between the tutorial and the source code or modref. That is, a relatively complete reference to the most important parts of the language such as constructs and important features, but not a function reference (important functions such as Stdio and the like will be covered). My plan is to assume basic programming knowledge that isn't necessarily assumed in the current tutorial online. I've gotten a good bit of feedback regarding what's missing, from programming savvy individuals that have tried to pick up pike.
I've placed a first crack at a table of contents here:
http://hww3.riverweb.com/dist/PikeManual.txt
Any and all feedback would be greatly appreciated (additions, deletions, reorganizations, etc)
Also, unrelated to this effort, I was wondering who owned the copyright on the current tutorial... does anyone know? I was thinking of getting a few copies of this material printed and bound, but don't want to end up with a lawyer at my door. If there's interest from anyone out there, please let me know.
- The pike@roxen.com mailing list archive
As part of my research into topic #1 above, I got thinking that there's a large amount of good information locked away in the mailing list archives. Unfortunately, the only way to get at it right now is to use the mailing list archive server, which is relatively inconvenient. In order to remedy this situation, I've put a very simple, searchable archive online here:
http://modules.gotpike.org:8000/list/
It's not fulltext search (my mysql is apparently not happy about doing fulltext), but it does use substring searching, so it's at least as good as a simple grep. It will probably move to a more suitable location in the future. Thanks to Martin Bahr for the archive mailbox, going back 7 years.
As always, comments and feedback are welcome...
Bill
/ Brevbäraren
/ Brevbäraren