David, We are actively working on documentation. Please see a number of recent posts on the subject.
David On Wed, Nov 26, 2008 at 11:07 AM, David Stein <[EMAIL PROTECTED]> wrote: > > After digging into some sample Lift apps, I can smell the awesomeness > and really want to jump in right away. Now that the Scala book has > been printed, I feel that Scala in general and Lift in particular will > both attract many more curious people. I don't mean this as a > criticism of Lift (which is impressive), but the documentation is > severely lacking. Needing to troll through undocumented APIs will > certainly turn people off and could perhaps squander some natural > momentum that seems to be building around Scala. I know there are two > books in the works, but I don't think the community can afford to > wait. > > I'd like to challenge each committer to take responsibility for a > portion of the API and fully document it in Scaladocs by year's end. > I think there are 6-12 of you and 14 packages, so I don't see it as > being a lot of work. Once there are glimpses of better documentation, > I'm certain people who aren't Scala/Lift experts will begin writing > tutorials and contributing documentation and sample projects of their > own. Right now, it's like walking into an Egyptian tomb and trying to > decipher hieroglyphics without a Rosetta stone. We all know writing > documentation is a chore, but perhaps you can find inspiration in > thinking that once your APIs are documented, thousands of people will > use your creation and sing your praises at conferences around the > world. > > I'm sure we all can think of similarly awesome technologies which > weren't widely adopted, perhaps because they were just too advanced > for the current state of the market. Smalltalk comes to mind, as do > early versions of WebObjects. BeOS anyone? I'd hate for Lift to not > enjoy its moment in the sun simply for lack of documentation. > > Tally-ho! > > > > -- Lift, the simply functional web framework http://liftweb.net Collaborative Task Management http://much4.us Follow me: http://twitter.com/dpp Git some: http://github.com/dpp --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Lift" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/liftweb?hl=en -~----------~----~----~----~------~----~------~--~---
