Hi, Markus, I was glad to hear from you, but I have to agree with Jani: this is not how things are done. Consider this one line: > 706 files changed, 123369 insertions(+), 752 deletions(-) Something like that will be a huge red flag to any kernel maintainer! In the kernel community, we have spent the last 25 years figuring out a development model that is based on gradual, incremental changes, each of which can be reviewed on its own merits. It does *not* encompass wholesale replacements of existing code — even in situations where that code was not just merged after a year of discussions, negotiations, and false starts. I simply cannot accept this pull request. Markus, we all very much want your help in this work. You have expertise and energy that could really push the documentation effort forward. But it needs to be done the way kernel developers do it: cooperatively, incrementally, and always mindful of the entire community's needs. I would love it if you would take the flat-table and man-page work, separate them out, and make them work with the *existing* Sphinx-based scheme. If you can do it soon, we can maybe get it into 4.8. Can you focus on that for now, please? As for the rest, what we have now is certainly far from perfect; we're figuring a lot of this out as we go. Incremental improvements are welcome, and each will be evaluated independently. Please help us to make the kernel's documentation better that way. Thanks, jon -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
