Hi Dave, thanks for your great reminder! We'll add those rules. Yu, signormercurio, urfreespace
On Tue, Aug 23, 2022 at 10:33 PM Dave Fisher <wave4d...@comcast.net> wrote: > 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 > >>> > >>> > >
