Results 1 to 10 of 12

Thread: Q: Is missing documentation for a shipping feature a 'bug' or an 'enhancement'?

Hybrid View

  1. #1
    Join Date
    Oct 2012
    Posts
    20
    Rep Power
    3

    Exclamation Q: Is missing documentation for a shipping feature a 'bug' or an 'enhancement'?

    For features that ship with ZCS, are missing official TechDocs (install, config, etc) considered a 'bug' or an 'enhancement' by @Zimbra?

    Specifically, when WE file @bugzilla about the missing docs, what 'Severity' should be selected?

    Here's one example -- missing cbpolicyd documentation (https://bugzilla.zimbra.com/show_bug.cgi?id=70376) -- that:

    (1) was filed over a year ago (2012-02-21) as an 'enhancement' to v7.1.4
    (2) hasn't been completed in/by 8.0.4
    (3) can't get any attention/response from the "Assigned To"
    (4) won't allow users to modigy "Version Found" or "Severity"

  2. #2
    phoenix is offline Zimbra Consultant & Moderator
    Join Date
    Sep 2005
    Location
    Vannes, France
    Posts
    23,587
    Rep Power
    58

    Default

    Quote Originally Posted by dvirt View Post
    For features that ship with ZCS, are missing official TechDocs (install, config, etc) considered a 'bug' or an 'enhancement' by @Zimbra?

    Specifically, when WE file @bugzilla about the missing docs, what 'Severity' should be selected?

    Here's one example -- missing cbpolicyd documentation (https://bugzilla.zimbra.com/show_bug.cgi?id=70376) -- that:

    (1) was filed over a year ago (2012-02-21) as an 'enhancement' to v7.1.4
    (2) hasn't been completed in/by 8.0.4
    (3) can't get any attention/response from the "Assigned To"
    (4) won't allow users to modigy "Version Found" or "Severity"
    In the bug report you mention there is a link to the 'official' Zimbra Certified cbpolicyd documentation on the wiki, did you read that? Does that not tell you what you need to know? If it's missing some content then file an RFE for that. FWIW, you won't necessarily get any immediate response to comments you add to that bug report and you won't have the authority to modify the status and product version in that bug report.
    Regards


    Bill


    Acompli: A new adventure for Co-Founder KevinH.

  3. #3
    Join Date
    Oct 2012
    Posts
    20
    Rep Power
    3

    Default

    Quote Originally Posted by phoenix View Post
    you mention there is a link to the 'official' Zimbra Certified cbpolicyd documentation on the wiki
    Actually, no, I don't. I refer specifically (https://bugzilla.zimbra.com/show_bug.cgi?id=70376#c13) to "unofficial, work-in-progress" @ the wiki.

    A quick search @ the Wiki, it states clearly "This article is a Work in Progress, and may be unfinished or missing sections."

    Quote Originally Posted by phoenix View Post
    did you read that?
    Yes

    Quote Originally Posted by phoenix View Post
    Does that not tell you what you need to know?
    No

    Quote Originally Posted by phoenix View Post
    If it's missing some content
    It is. The 1st post of the already existing RFE identifies some of the issues.

    The other bug (https://bugzilla.zimbra.com/show_bug.cgi?id=39093), identifies additional unaddressed request for doc'ing the admin UI.

    Neither of the official Admin Guides

    http://files.zimbra.com/website/docs...uide_8.0.4.pdf

    nor

    http://files.zimbra.com/website/docs...uide_8.0.4.pdf

    address any install or configuration.

    Simply, there's no thorough, step-by-step example, with Zimbra-specific recommendations if/as required, of either cbpolicyd server or adminUI install, configuration, or usage w.r.t. "Quota" (its oft-default use case), or "Greylisting" (its very-frequent use case).

    Quote Originally Posted by phoenix View Post
    then file an RFE for that.
    I did (https://bugzilla.zimbra.com/show_bug.cgi?id=81268). It was closed, and merged into the bug referenced here, in this post (https://bugzilla.zimbra.com/show_bug.cgi?id=70376), which is an 'enhancement', and has not been addressed. That's the point of this forum question.

  4. #4
    Join Date
    May 2007
    Location
    Zimbra
    Posts
    1,285
    Rep Power
    10

    Default

    I have been actively updating Postfix Policyd - Zimbra :: Wiki as I have time. There were a number of issues with policyd in 8.0.0 through 8.0.3. 8.0.4 is better, except it doesn't add in the new accounting & amavis schema by default. There's a bug to do that on the 8.0.5 upgrade, or you can do it manually yourself if you like (if you have need of either).

    --Quanah
    Quanah Gibson-Mount
    Server Architect
    Zimbra, Inc
    --------------------
    Zimbra :: the leader in open source messaging and collaboration

  5. #5
    Join Date
    Oct 2012
    Posts
    20
    Rep Power
    3

    Default

    Quote Originally Posted by quanah View Post
    I have been actively updating Postfix Policyd - Zimbra :: Wiki as I have time.
    It would probably be useful to both posters & users to consolidate/organize the various policyd-related pages into one.

    Still would like to know whether missing docs are considered a 'bug' or 'enhancement' request.

    In any case, it'd be helpful to see the DOC REQUEST actually promoted to @pm.zimbra.

  6. #6
    Join Date
    May 2007
    Location
    Zimbra
    Posts
    1,285
    Rep Power
    10

    Default

    I've been consolidating them as I have time. Eventually there will be only one.
    Quanah Gibson-Mount
    Server Architect
    Zimbra, Inc
    --------------------
    Zimbra :: the leader in open source messaging and collaboration

Similar Threads

  1. Missing documentation?
    By emiro in forum Administrators
    Replies: 3
    Last Post: 02-05-2010, 07:12 AM
  2. Missing Import/Export Feature in 5.0.9
    By f4lexluder in forum Migration
    Replies: 1
    Last Post: 02-20-2009, 01:54 PM
  3. Cosmetic 'bug' in the folderview
    By JOlsen in forum Error Reports
    Replies: 1
    Last Post: 08-21-2008, 12:16 AM
  4. iSync - where is feature set description / documentation?
    By glawrie in forum CalDAV / CardDAV / iSync
    Replies: 4
    Last Post: 10-03-2006, 11:06 PM

Tags for this Thread

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •