Josh Marshall <joshua.r.marshall.1991@xxxxxxxxx> writes: > Hello Carlos, > > This is a generational shift. For my peers, we understand the benefit > of keeping everything in a thread. But at some point it becomes so > verbose and cumbersome as to defeat the purpose. The size of the text > I'm working with and the number of text changes it has seen meets that > level. And so I've kept it in git and referenced that. Nonetheless, you are trying to engage with the kernel community, and will have far better results if you follow that community's norms. Those include sending patches by email and not top posting. They also include listening to the advice you are being given. Like others, I appreciate your efforts to improve our documentation; it certainly needs it! But please think about improving the *existing* documentation, rather than creating yet another file, disconnected from the rest. We already have far too much of that. Thanks, jon