Hi Sam, 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? - Jonas -- * Jonas Smedegaard - idealist & Internet-arkitekt * Tlf.: +45 40843136 Website: http://dr.jones.dk/ [x] quote me freely [ ] ask before reusing [ ] keep private
signature.asc
Description: signature
