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