I've had a bit of a break from Lift and coming back I find myself
annoyed that I didn't write some notes last time and am having to go
back to searching through the various bits of documentation to figure
things out.

Anyway, after much thought I decided that the best way to write my
notes would be to supplement the API docs (ie. the Scaladoc
documentation in the code base). so that I can view context sensitive
help in my IDE of choice and others can benefit from my labours!

So, question 1…

The current API docs are very light on documentation and sometime ago
I noticed some notice about removing documentation from the code
base.   Is there some policy about not having documentation in the
code or any thought on whether it should adhere to the Scaladoc 2
syntax?

Question 2…

This is only really going to work if the process of submitting the
documentation is reasonably straightforward so… What's the easiest
possible way of submitting documentation changes to the code base? (if
indeed this is something the core team would welcome).   I was
thinking of perhaps emailing git patch files to someone in the core
team who can verify that the comments are right before checking them
in.  Any thoughts?

If there is a reasonably explainable approach, it could be added as a
Wiki page to encourage wider participation.

Best,

Stuart.

-- 
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.

Reply via email to