acassis commented on PR #20625: URL: https://github.com/apache/nuttx/pull/20625#issuecomment-6130500998
> To be completely honest, I'm not sure why we're merging stuff like this. Do we really need to explain scheduling with metaphors in our docs? I think this is something users should seek to learn elsewhere. > > This is where I take issue with AI generated docs. This is verbose and reads like AI generated content, without really adding much benefit to our docs. I'm not going to block this PR but I really think we need to reconsider how we're writing docs. NuttX docs are already bad (the precursor PR to this one has helped to fix that!) but adding AI generated text is going to turn more people off reading it. If no one writes the docs themselves, who really understands NuttX? @linguini1 this is not AI issue, @vrmay23 asked AI to be more didactic and explain what is a scheduler for an end user. Actual it was my suggestion because in his initial proposal he never explained what a scheduler was. I think we should use other RTOSs as base to create a better documentation. I think don't need to be so didactic here because the documentation should server newcomer and experienced users. It should be a reading good for newcomer and experts at the same time -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
