s1037989 has asked for the wisdom of the Perl Monks concerning the following question:

I have two modules to release and need to get feedback. I've never posted a module to CPAN before and do I have my PAUSE account. I'm first looking for feedback on the name and then if anyone's interested I can post the code for review before posting to CPAN. Or should I post to CPAN first? My two modules (names open to feedback):
Clients(3) User Contributed Perl Documentation Cl +ients(3) NAME Config::LDAP::Clients - Perl extension for mimicking ldap*(1) a +rgu- ments. SYNOPSIS use Config::LDAP::Clients; my $ldapclients = new Config::LDAP::Clients; print "$_: ", $ldapclients->$_, "\n" for $ldapclients->option +s; print "Remaining ARGV: ", join(', ', @ARGV), "\n"; my $ldap = $ldapclients->connect; $ldap->search(...); DESCRIPTION This module provides all arguments available to the ldap*(1) ut +ilities and uses Config::LDAP::Conf to set defaults based on ldap.conf( +5). CONSTRUCTOR new ( OPTIONS ) method => {search?modify?add?delete?passwd?modrn} METHODS connect ( [new] ) Connect and bind to Net::LDAP with processed options accord +ing to ldap.conf(5) and ldap*(1). [new] = hashref of options options ( [option] ) Returns an array of arguments that were set according to ld +ap*(1). [option] = Returns a scalar if option was properly set in a +ccor- dance with ldap*(1) or if option = '*' then return all opti +ons for the selected ldap*(1) utility, regardless of whether or not + the option was set. show ( ) Prints all items found according to ldap*(1). Single-letter methods These are the single-letter methods based on the arguments +avail- able to the ldap*(1) utilities. search n c u v t T F A L M S d f x D W w y H h p b s a P e E l + z O I Q U R X Y Z modify, add a c S n v M d D W w y H h p P O I Q U R x X Y Z f delete n v c M d f D W w y H h P p O U R r x I Q X Y Z passwd A a t D d H h n p S s T v W w y O I Q U R x X R Y Z modrdn r s n v c M d D W w y H h p P O I Q U R x X Y Z f ldapconf ( ) Returns the Config::LDAP::Conf object used to compute defau +lts per ldap.conf(5). SEE ALSO Config::LDAP::Conf ldapsearch(1), ldapmodify(1), ldapadd(1), ldapdelete(1), ldappa +sswd(1), ldapmodrn(1) AUTHOR Stefan Adams, <stefan@cogentinnovators.com> COPYRIGHT AND LICENSE Copyright (C) 2010 by Stefan Adams This library is free software; you can redistribute it and/or m +odify it under the same terms as Perl itself, either Perl version 5.8.8 +or, at your option, any later version of Perl 5 you may have available +. perl v5.8.8 2010-02-23 Cl +ients(3)
------------------------------------------------------------------------------------------------------------
Config::LDAP::Conf(3) User Contributed Perl DocumentationConfig::LDAP: +:Conf(3) NAME Config::LDAP::Conf - Perl extension for mimicking ldap.conf(5) p +rocess- ing. SYNOPSIS use Config::LDAP::Conf; my $ldapconf = new Config::LDAP::Conf; print $ldapconf->base, "\n"; $ldapconf->base('dc=example,dc=com'); print $ldapconf->base, "\n"; DESCRIPTION This module follows all the guidelines in ldap.conf(5) for readi +ng defaults from files and the environment. All methods accept an optional value to set as the first paramet +er. All methods return the current value of the option. Some methods provide value checking operations to adhere to the +guide- lines in ldap.conf(5). If the value passes it is used, if not i +t is set to the default value noted in ldap.conf(5). CONSTRUCTOR new ( ) METHODS show ( ) Prints all items found according to ldap.conf(5). uri ( [uri] ) Sets if provided. Returns array of values. base ( [base] ) Sets if provided. Returns value. binddn ( [binddn] ) Sets if provided. Returns value. host ( [host] ) Sets if provided. Returns value. port ( [port] ) Sets if provided. Returns value. referrals ( [referrals] ) Sets if provided. Returns value. sizelimit ( [sizelimit] ) Sets if provided. Returns value. timelimit ( [timelimit] ) Sets if provided. Returns value. deref ( [deref] ) Sets if provided. Returns value. sasl_mech ( [sasl_mech] ) Sets if provided. Returns value. sasl_realm ( [sasl_realm] ) Sets if provided. Returns value. sasl_authcid ( [sasl_authcid] ) Sets if provided. Returns value. sasl_authzid ( [sasl_authzid] ) Sets if provided. Returns value. sasl_secprops ( [sasl_secprops] ) Sets if provided. Returns array of values. tls_cacert ( [tls_cacert] ) Sets if provided. Returns value. tls_cacertdir ( [tls_cacertdir] ) Sets if provided. Returns value. tls_cert ( [tls_cert] ) Sets if provided. Returns value. tls_key ( [tls_key] ) Sets if provided. Returns value. tls_cipher_suite ( [tls_ciper_suite] ) Sets if provided. Returns value. tls_randfile ( [tls_randfile] ) Sets if provided. Returns value. tls_reqcert ( [tls_reqcert] ) Sets if provided. Returns value. tls_crlcheck ( [tls_crlcheck] ) Sets if provided. Returns value. SEE ALSO ldap.conf(5) AUTHOR Stefan Adams, <stefan@cogentinnovators.com> COPYRIGHT AND LICENSE Copyright (C) 2010 by Stefan Adams This library is free software; you can redistribute it and/or mo +dify it under the same terms as Perl itself, either Perl version 5.8.8 o +r, at your option, any later version of Perl 5 you may have available. perl v5.8.8 2010-02-22 Config::LDAP: +:Conf(3)

Replies are listed 'Best First'.
Re: New Config::LDAP::* modules?
by biohisham (Priest) on Feb 24, 2010 at 10:56 UTC
    Congrats..the documentation is terse.. This link answers the PUASE requirements.. also you might find this FAQ subset useful.

    How about throwing in some quick examples to clarify some points like in this part?

    CONSTRUCTOR new ( OPTIONS ) method => {search?modify?add?delete?passwd?modrn}


    Excellence is an Endeavor of Persistence. Chance Favors a Prepared Mind.