[GitHub] [incubator-pinot] akshayrai commented on issue #4146: [TE] Migrating documentation to readthedocs.io

[GitBox <gi...@apache.org>]

akshayrai commented on issue #4146: [TE] Migrating documentation to readthedocs.io
URL: https://github.com/apache/incubator-pinot/pull/4146#issuecomment-484980537
 
 
   Thanks @tangdian for putting this together. But I have some concerns with the maintenance of this doc.
   
   Editing a doc in code is not only hard to format and preview but demotivating due to the long steps to make even a minor correction (raise PR, get ship it, push code). Given that our docs frequently get appended, this will be a pain. UMP team which earlier used readthedocs moved away from it. So I presume it didn't work out well.
   
   Let's review what other solutions we have. Github wiki is not a bad option to consider. It is easy to edit and has decent formatting capabilities.

----------------------------------------------------------------
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.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@pinot.apache.org
For additional commands, e-mail: commits-help@pinot.apache.org