+1

Enrico Olivelli <eolive...@gmail.com> 于2021年7月13日周二 下午4:14写道:

> +1
>
> Enrico
>
> Il giorno mar 13 lug 2021 alle ore 10:12 Sijie Guo <guosi...@gmail.com>
> ha scritto:
>
>> +1
>>
>> On Mon, Jul 12, 2021 at 8:25 PM Anonymitaet _ <anonymita...@hotmail.com>
>> wrote:
>> >
>> > Hi Pulsar enthusiasts,
>> >
>> >
>> >
>> > Nowadays, Pulsar grows rapidly, docs are in increasing demands. While
>> some users have a hard time finding what they need or encountering other
>> issues.
>> >
>> >
>> >
>> > As a sustainable community, we always give the same care to docs as
>> code. To improve the UX, may we suggest upgrading the Pulsar website
>> framework (Docusuraus) and re-architecture the doc structure?
>> >
>> >
>> >
>> > # Issue
>> >
>> > Currently, the Docusuraus version is 1.11, which is an old version
>> released in 2019. With this version, we cannot customize features based on
>> our needs (for example, navigation is a cornerstone for the site. We want
>> to optimize it but cannot add more levels for it or collapse it, etc).
>> >
>> >
>> >
>> > # Solution
>> >
>> > Upgrade Docusuraus from 1.11 to the latest version (2.x).
>> >
>> >
>> >
>> > # Benefit
>> >
>> > Difference between 1.11 and 2.x:
>> >
>> > 1.11 is a pure documentation site generator, using React as a
>> server-side template engine, but not loading React on the browser.
>> > 2.x, rebuilt from the ground up, generates a single-page-application,
>> using the full power of React in the browser. It allows for more
>> customizability but preserved the best parts of 1.11 - easy to get started,
>> versioned docs, and i18n. Beyond that, the latest version is a performant
>> static site generator and can be used to create common content-driven
>> websites (e.g. Documentation, Blogs, Product Landing and Marketing Pages,
>> etc) extremely quickly. For how to upgrade, see
>> https://docusaurus.io/docs/migration/automated.
>> >
>> >
>> >
>> > If there is a better tool or any other suggestions, feel free to
>> comment. We'd love your feedback, thanks!
>> >
>> >
>> >
>> > Anonymitaet
>> >
>> >
>> >
>> >
>>
>

Reply via email to