jeantil commented on PR #2925: URL: https://github.com/apache/james-project/pull/2925#issuecomment-3810230874
> I bet now is about time to work on the overall content now that the form looks nicer... The content is not so bad. I started building the documentation because I intended to find a place to write down what I learned about the BlobStore recently :d From my pov, what's missing ( or the location is unclear or duplicated ) is - reference documentation on the configuration files. - how-tos I'm a bit torn about the choice of using includes in the server's documentation. It makes it easier for users looking for a specific server's configuraton setup but it mostly duplicates content and makes linking to a specific configuration use case from other sections difficult (see customization for instance) I noticed that the [index of the configuration section](https://raw.githubusercontent.com/apache/james-project/refs/heads/master/docs/modules/servers/pages/basic/configure/index.adoc) for the basic server contained a lot of comments I haven't read it all yet, maybe that's where the reference configuration is supposed to live -- 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] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
