snuyanzin commented on pull request #17527:
URL: https://github.com/apache/flink/pull/17527#issuecomment-976766385


   Thanks for you feedback @MartijnVisser 
   
   I would agree with you if information from site is not available offline or 
is in a separate repo. However in fact both code and site content are in the 
same repository. 
   From one side yes, you are right, that being offline it is a bit tricky to 
open site, however from another side I know a header mentioned in README => I 
can do search by exact match across the repository I have downloaded (in case I 
don't know where to look for). 
   
   As far as I can see there is a whole Flink Development section at Flink site 
where it is described how to setup IDE (README also refers to that part of 
site) and lots hints which are not mentioned at README.
   So it looks like being offline should not be an issue to find such info.
   
   Probably the issue is that if we put a simple markdown link between README 
and docs from `docs` content then it will lead to 
https://github.com/apache/flink/blob/master/docs/content/docs/flinkDev/building.md
 which contains some `hugo` specific tags while 
https://nightlies.apache.org/flink/flink-docs-master/docs/flinkdev/building/ 
has the same info in a more human friendly rendered way
   


-- 
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]


Reply via email to