Just a quick LotusScript tip:
Hopefully you've been inspired by my recent adventures in creating custom LotusScript classes. If so, you'll have noticed that, when creating your own properties and methods in these classes that they get their own comments added in.
For example, if you type "property get foo as string" and then press return, you'll see something like this:
%REM Property Get Foo Description: Comments for Property Get %END REM Property Get Foo As String End Property
Domino Design auto-adds the comments above the property for you.
It's easy to see this as an annoyance and find yourself taking the comments out to keep your code tidy. However, I've forced myself to stop doing that and now make a point of adding in a meaningful comment. Like so:
%REM Property Get Action Description: Value of the "Action" field, which is used by the workflow associated with most documents Value is only available when editing/saving (not stored on document)! %END REM Property Get Action As String Action = GetFieldValue("Action") End Property
The benefit of doing so is manifold. Not only does it remind yourself what your intentions were but also, more importantly, future maintainers of the code.
But the real tip here is that, if you comment code using the standard way then, when you hover the mouse over a call to that property in use in your code you get to see the "documentation" inline. As below:
That alone makes it worth the time to document properly. Even if just for your own benefit as a quick reminder of what everything is.