royjacobson added a comment. In D142578#4087974 <https://reviews.llvm.org/D142578#4087974>, @tschuett wrote:
> I am not the only one who has a different background. If the introduction > says this is the introduction of the release notes, I am not super motivated > to read on. I would prefer to see some highlights to motivate the readers to > continue reading. You've mentioned what I think are separate issues - that this document is difficult to read for readers from different backgrounds and that the introduction might be too long or unengaging. I mostly agree about the first point - I've tried to do what I could to make it more accessible but I don't think it's enough. About the second point - I'm not really sure what to change. I think the 'potentially breaking changes' section is more important than the 'what's new' section, but the 'what's new' section IS the second section (and there's a table of contents). Are there specific topics you think we should remove from the introduction or move into the intro from the 'what's new' section? I'd like to avoid duplicating information if we can. Repository: rG LLVM Github Monorepo CHANGES SINCE LAST ACTION https://reviews.llvm.org/D142578/new/ https://reviews.llvm.org/D142578 _______________________________________________ cfe-commits mailing list cfe-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
