Skip Menu |

This queue is for tickets about the Authen-Bitcard CPAN distribution.

Report information
The Basics
Id: 75489
Status: new
Priority: 0/
Queue: Authen-Bitcard

People
Owner: Nobody in particular
Requestors: zefram [...] fysh.org
Cc: DMITRI [...] cpan.org
AdminCc:

Bug Information
Severity: (no value)
Broken in: (no value)
Fixed in: (no value)



Subject: missing doc
Date: Fri, 2 Mar 2012 22:17:07 +0000
To: bug-Authen-Bitcard [...] rt.cpan.org
From: Zefram <zefram [...] fysh.org>
The Authen::Bitcard documentation works from the assumption that the reader already knows how Bitcard works and just needs the surface details of how to access the protocol. In my case that's not the case. I was looking for documentation of the concepts behind Bitcard, such as what a Bitcard account represents, what attributes it has, and the security model. Ideally Authen::Bitcard ought to explain these things first. Failing that, it would be OK for A:B to point at documentation of these things that is located somewhere else, such as on www.bitcard.org, but there doesn't seem to be any such document either there or at typepad.com (which bitcard.org points at). -zefram