dave2wave opened a new issue #14696:
URL: https://github.com/apache/pulsar/issues/14696


   ### What issue do you find in Pulsar docs?
   
   There are many examples in `site2/docs/*.md` of external links that ought to 
internal.
   
   This makes new site architecture and staged new versions of the 
documentation VERY difficult to review.
   
   Every doc md file needs to be reviewed.
   
   You will find problems on pages with this issue in the next site.
   
   ### What is your suggestion?
   
   For example in `concepts-messaging.md`
   
   ```
   If the consumer fails to receive all chunks of a message within a specified 
time period, it expires incomplete chunks. The default value is 1 minute. For 
more information about the `expireTimeOfIncompleteChunkedMessage` parameter, 
refer to [org.apache.pulsar.client.api](https://pulsar.apache.org/api/client/).
   ```
   is best done as
   ```
   If the consumer fails to receive all chunks of a message within a specified 
time period, it expires incomplete chunks. The default value is 1 minute. For 
more information about the `expireTimeOfIncompleteChunkedMessage` parameter, 
refer to [org.apache.pulsar.client.api](/api/client/). 
   ```
   
   There are other issues on the new site that are related. Please visit 
https://pulsar-next.staged.apache.org/docs/next/concepts-messaging
   
   
   ### Do you have any references?
   
   Pick almost any page in `site2/docs` and there will be url issues.
   
   ### Would you like to fix this issue?
   
   This is a large effort. I'm willing to review results.
   
   ### Note
   
   - [X] I have researched my question.


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