cychiu8 commented on code in PR #21460: URL: https://github.com/apache/kafka/pull/21460#discussion_r2798828853
########## docs/getting-started/quickstart.md: ########## @@ -87,14 +87,14 @@ Start the Kafka Docker container: Kafka is a distributed _event streaming platform_ that lets you read, write, store, and process [_events_](/documentation/#messages) (also called _records_ or _messages_ in the documentation) across many machines. -Example events are payment transactions, geolocation updates from mobile phones, shipping orders, sensor measurements from IoT devices or medical equipment, and much more. These events are organized and stored in [_topics_](/documentation/#intro_concepts_and_terms). Very simplified, a topic is similar to a folder in a filesystem, and the events are the files in that folder. +Example events are payment transactions, geolocation updates from mobile phones, shipping orders, sensor measurements from IoT devices or medical equipment, and much more. These events are organized and stored in [_topics_](../introduction/#main-concepts-and-terminology). Very simplified, a topic is similar to a folder in a filesystem, and the events are the files in that folder. Review Comment: After checking with local, production site and the Hugo document regarding the path. **Conclusion**: the path without `.md` is the correct one. - Hugo document: https://gohugobrasil.netlify.app/content-management/urls/#pretty-urls >Hugo’s default behavior is to render your content with “pretty” URLs. No non-standard server-side configuration is required for these pretty URLs to work. - local: - without `.md` <img width="1099" height="883" alt="Pasted image 20260212210956" src="https://github.com/user-attachments/assets/4c945620-35b1-4ba2-a47c-aa5d799a3ddd"; /> <img width="1076" height="880" alt="Pasted image 20260212211139" src="https://github.com/user-attachments/assets/3ebaa6df-7c39-46f4-8dd8-01f16c0662e7"; /> - with `.md` (404 not found) <img width="1087" height="885" alt="Pasted image 20260212211308" src="https://github.com/user-attachments/assets/f1612b87-0cfa-4002-a26d-ebd88af42234"; /> <img width="955" height="311" alt="Pasted image 20260212211407" src="https://github.com/user-attachments/assets/d940da2e-98a1-4b0e-9cdc-c25a0603aca7"; /> - production - without `.md` <img width="1083" height="536" alt="Pasted image 20260212211632" src="https://github.com/user-attachments/assets/0b289caa-45e4-4b1d-b4ac-ec40792728a1"; /> - with `.md` (404 not found) <img width="833" height="171" alt="Pasted image 20260212211655" src="https://github.com/user-attachments/assets/84395b1b-ab53-4bb4-9619-1466452c1f31"; /> ---- **New finding and update: Use absolute path instead of relative path** However, when testing, I found it would be better to use absolute path instead of relative one because we have two entry points for the "Getting Started" page: top panel and side bar - top panel: <img width="1467" height="651" alt="Pasted image 20260212210510" src="https://github.com/user-attachments/assets/c054c04f-d44a-4b96-a9d0-6d2826326234"; /> - side bar: <img width="1076" height="737" alt="Pasted image 20260212210718" src="https://github.com/user-attachments/assets/f6660b36-7b3e-4fe6-a37f-be591afbac33"; /> -- 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]
