[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: [LCFC] templates://lwat/templates



On (13/03/07 18:40), Christian Perrier wrote:
> I have no idea either..:-) 
> 
> Maybe the maintainer can explain us....which would actually mean
> adding a long description..:)

That would be good.

> Ah, crap. Nicolas made a remark about this. This actually means that
> one can omit the DN part and just mention the "ou=" sequence.
> 
> At least, the is my understanding.

I have made this more explicit in my changes.

> > I'm not sure that the (0-9) is entirely clear. Would (characters 0-9) be
> > clear, or does that just add an extra word that could confuse?
> 
> Yep, good idea.

I also made this more explicit.

> 
> > Also, a more general question about the project. Is the aim to just
> > rewrite the templates for spelling and grammar, or should we be looking
> > at usability as well, and suggest additions and corrections where we
> > feel that the templates are lacking?
> 
> 
> In my point of view, this is certainly about both.

I think it would be good to help the maintainer improve the templates
generally. For one thing we are a group of people looking at these
templates like an unexperienced user would, which is often the hardest
mindset for a developer to get in to when dealing with a package they
are familiar with. However it would mean a lot more work for this
project.

To this end I have attached a version where I have added some things
that I would want to see if I was faced with this. I just made it up
though, so the maintainer would need to confirm my assertions, which may
make it a protracted process. The other alternative is actually trying
things out, or looking at the code to work out what is going on.

There are a few outstanding thoughts and questions I have.

  * Should the templates try and explain what the things are used for,
    for instance the LDAP server? It seems like someone installing this
    package would know why they needed to provide one, but taking them
    out of context it is not clear, so as a reviewer it is tempting to
    highlight this.
  * Should it define groups, hosts, netgroups etc?
  * I assumed that the password limits are applied when a user changes
    their password, but are they always autogenerated, or can the user
    not change it, or are the restrictions only on the initial generated
    password?
  * What are uppercase and lowercase characters? Is it locale dependent,
    or just [A-Z] and [a-z]?
  * What are the differences between the templates?

> 
> Of course, we will face situations where none of us has the experience
> (see "lisGroups" above). There, we'll need to ask maintainers for more
> input, but in such case, we might expect that an usability issue
> exists..:)
> 
> Avoiding any kind of jargon is, for instance, something we really
> should keep in mind. Jargon is likely to prevent the accessibility of
> technology.
> 

True, I was going to say it presented a particular localisation problem,
but in fact jargon is jargon in any language, and is probably equally
cryptic to us all.

Apologies for doing this in response to your LCFC mail.

Thanks,

James

-- 
  James Westby   --    GPG Key ID: B577FE13    --     http://jameswestby.net/
  seccure key - (3+)k7|M*edCX/.A:n*N!>|&7U.L#9E)Tu)T0>AM - secp256r1/nistp256
Index: tmp/templates
===================================================================
--- tmp.orig/templates	2007-03-13 19:10:56.000000000 +0000
+++ tmp/templates	2007-03-13 19:21:13.000000000 +0000
@@ -34,50 +34,60 @@
 Default: ou=Group
 _Description: Prefix for groups on the LDAP server:
  Please enter the prefix under which the groups information is
- stored. Only the last part is needed.
+ stored. If one is not used then "ou=" is a valid answer.
 
 Template: lwat/authprefix
 Type: string
 Default: ou=AuthGroup
 _Description: Prefix for authorization groups on the LDAP server:
  Please enter the prefix under which the authorization groups
- information is stored. Only the last part is needed.
+ information is stored. If one is not used then "ou=" is a valid answer.
 
 Template: lwat/hostprefix
 Type: string
 Default: ou=Hosts
 _Description: Prefix for hosts on the LDAP server:
  Please enter the prefix under which the hosts information is
- stored. Only the last part is needed.
+ stored. If one is not used then "ou=" is a valid answer.
 
 Template: lwat/netgroupprefix
 Type: string
 Default: ou=Netgroup
 _Description: Prefix for netgroups on the LDAP server:
  Please enter the prefix under which the netgroups information is
- stored. Only the last part is needed.
+ stored. If one is not used then "ou=" is a valid answer.
 
 Template: lwat/minPwLength
 Type: string
 Default: 5
 _Description: Minimum length of the password for users:
  Please choose the minimum length for users' passwords. By default,
- lwat will autogenerate 8 characters long passwords.
+ lwat will auto generate 8 characters long passwords. The user can change
+ this afterwards, but they will not be able to select a password with a
+ length that is shorter than the value chosen here. Enter 0 to disable this
+ check.
 
 Template: lwat/minPwNumber
 Type: string
 Default: 1
-_Description: Minimum number of digits (0-9) in passwords:
+_Description: Minimum number of digits (characters 0-9) in passwords:
+ The passwords chosen by by users will be checked to ensure that they have a
+ minimum number of digits in them. Digits are defined to be the characters
+ 0-9. Enter 0 to disable this check.
 
 Template: lwat/minPwUpper
 Type: string
 Default: 1
 _Description: Minimum number of uppercase letters in passwords:
+ The passwords chosen by users will be checked to ensure that they have a
+ minimum number of uppercase letters in them. Enter 0 to disable this check.
 
 Template: lwat/minPwLower
 Type: string
 Default: 1
 _Description: Minimum number of lowercase letters in passwords:
+ The passwords chosen by users will be checked to ensure that they have a
+ minimum number of lowercase letters in them. Enter 0 to disable this check.
 
 Template: lwat/allowPwSet
 Type: boolean
@@ -95,3 +105,6 @@
  Lwat uses templates for creating user accounts, to make sure that
  home directories are placed in the right locations, users
  are member of the correct groups, etc.
+ .
+ There are several templates defined that may be applicable in specific
+ situations. If you do not wish to use a template then select None.

Reply to: