search

Bitmessage / PyBitmessage

Reference client for Bitmessage: a P2P encrypted decentralised communication protocol:
https://bitmessage.org/wiki/Main_Page
Other
2.83k stars 577 forks source link

Should licence headers be turned into docstrings or remain a comments? #1435

Open g1itch opened 5 years ago

g1itch commented 5 years ago

Hello!

That's the question arisen by recent rebase I've done (7f96b36). Some modules taken from third party (like namecoin or network.asyncore_pollchoose) have the licence headers which were turned into docstrings by @coffeedogs. Though I've seen a python packages with similar formatting style (like jsonrpclib) I still don't understand the reason to have the licenses in documentation.

Let's clarify the bitmessage's style guide in this case.

g1itch commented 4 years ago

I assume they should remain comments or turned back into comments.

g1itch commented 4 years ago

I see it again in #1554

PeterSurda commented 4 years ago

I would say we add licenses of individual files into the LICENSE file in project root.