kcexn commented on issue #5454: URL: https://github.com/apache/openwhisk/issues/5454#issuecomment-1833137896
@style95 with regards to documentation. The biggest problem to me seems like organisation. Most things seem to be there, but not easily found. I think maybe if there was a hierarchy or a better sense of organisation around how the documentation should work, maintaining it would be much easier. E.g. Maybe organise everything in a directory tree. With subdirectories for Development, Deployment, Architecture etc. Might be worth considering as an enhancement proposal? I think once the documentation has a structure, it will be easier for members of the community to help keep it up to date. As it stands, it's often unclear whether documentation is missing, incomplete, out of date, or I haven't looked hard enough. -- 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: issues-unsubscr...@openwhisk.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org