Skip to Main Content
HCL Domino Ideas Portal

Welcome to the #dominoforever Product Ideas Forum! The place where you can submit product ideas and enhancement request. We encourage you to participate by voting on, commenting on, and creating new ideas. All new ideas will be evaluated by HCL Product Management & Engineering teams, and the next steps will be communicated. While not all submitted ideas will be executed upon, community feedback will play a key role in influencing which ideas are and when they will be implemented.

For more information and upcoming events around #dominoforever, please visit our Destination Domino Page

Status Under Consideration
Workspace Domino Designer
Categories LotusScript
Created by Guest
Created on Jan 24, 2022

Create proper documentation for new classes and features as soon as they are published!

I'm filing this under "LotusScript but it's true for other topics as well, and I'm talking about online AND offline versions of Designer help:

New classes and features must be properply documented as soon as they are published, esp. if they aren't self-explanatory!

Some random example (but not the only one): with V 12.0.0 the new "NotesQueryResultsProcessor" LotusScript / Java class was implemented. An object is created through a new NotesDatabase method. But that method isn't mentioned at the NotesDatabase class itself, not even after V 12.0.1 was released.

For the same class there are the properties "MaxEntries" and "TimeOutSec". Under Usage in both "documentations" it says "If not specified,". And that's it then. It doesn't say whether they are read-only, or read-write, etc.

  • Attach files
  • Guest
    Reply
    |
    Jan 25, 2022

    The missing link from the NotesDatabase class was identified and addressed in 12.0.1 documentation.

  • Guest
    Reply
    |
    Jan 25, 2022

    Can the designer help please go back into a Notes database? This is way more handy than the current help and easier to search.

  • Admin
    Thomas Hampel
    Reply
    |
    Jan 25, 2022

    Updates for "MaxEntries" and "TimeOutSec" are in progress - seems like some text was cut off.

  • Guest
    Reply
    |
    Jan 25, 2022

    Ah, yes, you're right. But it still is missing from the offline help that is installed with V 12.0.1 Designer, at least here on my machine (which is also true for many other more recent methods, btw). I agree that I should have mentioned I was referring to the offline version (which not only for me - I assume - is the main starting point when looking for a solution, explanation or examples to a rarely used class or method).

    So, while the 2nd and 3rd example holds true for both documentations, with the 1st one I only hit the nail halfways, I'm afraid ;)


  • Admin
    Thomas Hampel
    Reply
    |
    Jan 25, 2022

    Propper documentation is a musthave, so yes, fully agree with your request.

    Following up on your example, the method to get the QueryResultProcessor object from a NotesDatase is documented since v12:

    see NotesDatabase class

    https://help.hcltechsw.com/dom_designer/12.0.0/basic/H_NOTESDATABASE_CLASS.html

    + GetQueryResultsProcessor method:

    https://help.hcltechsw.com/dom_designer/12.0.0/basic/H_GETQUERYRESULTSPROCESSOR_METHOD.html