Quoting Andrej Shadura (2020-04-29 12:58:29) > 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?
The _protocol_ has no ".org" in its name, and the _hostname_ should not be capitalized. So no, I dislike such change. Since you make those suggestions, do you think that it is still ambiguous which "matrix" the description talks aboout, even after my changes shared above? > By the way, the package is already in the matrix-team group on salsa, > would you also like to add the team to Uploaders? Team is listed in Maintainer field. I have no intention of listing non-humans in the Uploaders field. Or did I misunderstand you and you meant some other change than that? - 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
