Hi Rene,

Thanks for your reply. Sorry I just sent out my last email without having seen 
yours. My comments inline.

>> To continue with the documentation (at least on the path I have taken so 
>> far) I need to better understand the vision. That will allow me to resolve 
>> and clarify the topics previously raised regarding the community’s approach 
>> to dealing with newbies.
> 
> Well I believe a bit like Benoit on this. I think most of the time, users are 
> asking stuff because, as I raised in point 3, our documentation is outdated, 
> mixed between different products all together, not versioned, and very 
> confusing.
> 
> With the efforts made on rebranding our products towards a more 
> understandable user approach and reworking the documentation with Antora, 
> with a versioning, and having a clear separation between James flavors, it 
> would already help a lot more the users on how to use James regarding their 
> needs, and might decrease the overall need for help with the community.
> 
> Also the release process was a bit long and painful as I understood, thus we 
> were only updating the doc when doing a release, so lots of fixes stay 
> hanging for a while. I believe with Antora and Eugen work to automate the 
> build and website release he did (I hope I'm not wrong?), it might make it 
> much easier as well to keep our documentation up-to-date.

Great! So it sounds like there **is** some interest in taking a more 
user-centric approach. That is exactly what I am trying to gauge and 
understand. 😀


> I believe as well trying to add a bunch of how-tos regarding the topics that 
> an admin might likely be interested to setup with James or what seems to be 
> recurrent struggles of users might help too.

That would be great!!


> Honestly thank you greatly for all the time and thinking you have been 
> putting into this new James documentation with a more user-focused mindset. I 
> believe it helped the project greatly being more community friendly !

Thank you for letting me know. I am relieved that it is useful. 😅 In that case, 
I am happy to continue, albeit at an even slower pace.

Cheers,
=David


---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscr...@james.apache.org
For additional commands, e-mail: server-dev-h...@james.apache.org

Reply via email to