Hi Sam and Jonas, On Wed, 29 Apr 2020 at 12:51, Jonas Smedegaard <[email protected]> wrote: > Quoting Sam Hartman (2020-04-29 11:53:21) > > I can't tell from the short description whether this is for the Matrix > > chat client, linear algebra, or something else. > > It's *probably* not linear algebra from the descriptions and http > > emphasis, but I shouldn't have to guess at that. > > If it's part of the matrix.org set of packages I'd like to be able to > > tell whether this would be a reasonable point for a library to write a > > bot or client, or whether I'm looking for something at a different > > layer.
> > Thanks for your packaging work, but when you get a chance please improve > > the description so I can tell what technology this is and when I might > > want it. > Thanks for reporting this. > I agree that description does not clearly communicate that it is the > chat protocol (not the mathematical matrices). I have now clarified > that in both short and long descriptions. > > Your other point on when to use I am less sure about: Seems to me that > description is clear about the scope being "matrix client". It leaves > out which exact kinds of clients because (in my understanding) it is not > targeted specific types of clients - and it feels odd to me to spell > that out. > > This is my current draft of new description (replacing short description > and adding a section to long description, both to clarify which "matrix" > it is): > > Description: python no-IO library for the matrix chat protocol - Python3 > > library > > Nio is a multilayered Matrix client library. > > The underlying base layer doesn't do any IO on its own. > > On top of the base layer, > > a no-IO HTTP client implementation exists, > > as well as a full fledged batteries included asyncio layer > > using aiohttp. > > . > > Matrix is an open standard and lightweight protocol > > for real-time communication. > > Do you perhaps have suggestions for further improvements? How about s/[mM]atrix/Matrix.org/ in the short description and in the first line of the long one? By the way, the package is already in the matrix-team group on salsa, would you also like to add the team to Uploaders? -- Cheers, Andrej
