If page urls change then we should also add http redirect rules to help users who bookmarked these docs.
Sent from my iPhone > On Aug 23, 2022, at 5:53 AM, Yu <li...@apache.org> wrote: > > Hi team, > > Now is 3 working days after the initial discussion > > We'll start replacing brodocs with docsify for docs since there is no > objection or technical suggestions. > > Yu, signormercurio, urfreespace > >> On Fri, Aug 19, 2022 at 5:09 PM Yu <li...@apache.org> wrote: >> >> Thanks Dave! >> >>> How is this search organized on the server and how would this integrate >> with algolia? >> >> Search is performed at the front end, and it does not need to integrate >> with Algolia. >> >>> Google Analytics will be disallowed on ASF project sites very soon due >> to Privacy concerns with tracking data. I’ve warned about this several >> times. Please eliminate GA. If we need to track then we have options. >> >> Listing GA here just shows docsify's capabilities. >> As we discussed before [1], GA will no longer process new data in standard >> properties beginning July 1, 2023. >> Matteo is being considered to replace it. >> >> [1] https://github.com/apache/pulsar/issues/15664 >> >> Yu and signormercurio >> >> >> >> >> >> >>> On Thu, Aug 18, 2022 at 9:46 PM Dave Fisher <wave4d...@comcast.net> wrote: >>> >>> >>> >>> Sent from my iPhone >>> >>>> On Aug 18, 2022, at 4:55 AM, Yu <li...@apache.org> wrote: >>>> >>>> Hi team, >>>> >>>> To reduce manual work, we’re constantly implementing PIP 78: Generate >>> Docs >>>> from Code Automatically [1]. >>>> >>>> Docs here refer to the following： >>>> - Connector configurations [2] >>>> - Client configurations [3] >>>> - Pulsar CLI tools [4] >>>> - Pulsar configurations [5] >>>> - pulsar-admin [6] >>>> >>>> # Question >>>> >>>> Currently, some of the docs above [7] are generated using brodocs [8]. >>>> We’re wondering if it makes sense to replace brodocs with docsify? >>>> >>>> # docsify benefits >>>> >>>> ## For users >>>> - Enjoy new features (eg. search, copy to clipboard, language >>> highlighting, >>>> tabs, Disqus, etc.) >>> >>> How is this search organized on the server and how would this integrate >>> with algolia? >>> >>>> - More clear and organized layout >>>> >>>> ## For doc maintainers >>>> - Simple and lightweight >>>> - No statically built HTML files. Instead, it smartly loads and parses >>> .md >>>> files and displays them as a website. >>>> - Allow feature customization >>>> - Able to work with Google Analytics to track data >>> >>> Google Analytics will be disallowed on ASF project sites very soon due to >>> Privacy concerns with tracking data. I’ve warned about this several times. >>> Please eliminate GA. If we need to track then we have options. >>> >>> Also we never discuss GA anywhere within the PMC or developer community. >>> What value does it have? >>> >>> Dave >>> >>>> >>>> # Demo >>>> >>>> We’ve created a demo here [9]. >>>> This demo is only for demonstration purposes, so we just add a few >>>> improvements. It can be iterated later. >>>> >>>> ~~~~~~~~~~~~~~~~~~~~ >>>> >>>> If docsify is better, we’ll use it for all the docs above to provide a >>>> consistent content experience. >>>> >>>> Feel free to check and comment, thank you! >>>> >>>> [1] https://lists.apache.org/thread/638q6kmq81z2qjmyhgkqzp00sllh4x0w >>>> [2] https://pulsar.apache.org/docs/next/io-connectors (Configurations >>> for >>>> each connector) >>>> [3] https://pulsar.apache.org/docs/next/client-libraries-java >>>> (Configuration for each client. Here takes Java client as an example, it >>>> refers to configurations of client, producer, consumer, and reader) >>>> [4] https://pulsar.apache.org/docs/next/reference-cli-tools >>>> [5] https://pulsar.apache.org/docs/next/reference-configuration >>>> [6] https://pulsar.apache.org/tools/pulsar-admin/ >>>> [7] https://pulsar.apache.org/tools/ >>>> [8] https://github.com/Birdrock/brodocs >>>> [9] https://pulsar.apache.org/tools/pulsar-config/2.11.0-SNAPSHOT/#/ >>>> >>>> Yu, signormercurio, urfreespace >>> >>>
