I speak only for myself, but I am working in an environment where I am regularly checking docs all the way back to 1.8.x because we have legacy systems we cannot upgrade, and I am often referencing rules about schema canonical form. I value a lot the sidebar bottom version switching navigation from sites such as here https://fastavro.readthedocs.io/en/latest/writer.html#using-the-record-hint-to-specify-which-branch-of-a-union-to-take ... but I know it can be extraordinarily difficult to make it work correctly with these static site generators.
Lee Hambley http://lee.hambley.name/ +49 (0) 170 298 5667 On Thu, 4 Nov 2021 at 16:23, Martin Grigorov <[email protected]> wrote: > > > On Thu, Nov 4, 2021 at 5:04 PM Ismaël Mejía <[email protected]> wrote: > >> Wow this is pretty neat ! Nice job Martin! A modern website can >> encourage more contributions. >> I am more interested on content than aesthetics first. Is everything >> already migrated? Anything missing? Any issue to report? >> > > Everything is migrated for the documentation of the *current* version. > The old site contains documentation for both current and current-1. Is > this something you would like to preserve ? > > >> >> >> On Tue, Nov 2, 2021 at 7:01 PM Martin Grigorov <[email protected]> >> wrote: >> > >> > Hi, >> > >> > Anyone willing to send a PR with the suggested improvement? >> > Or at least open an issue with the well formulated text and I will add >> it! >> > >> > Regards, >> > Martin >> > >> > On Tue, Nov 2, 2021, 18:08 Oscar Westra van Holthe - Kind < >> [email protected]> wrote: >> >> >> >> Hi, >> >> >> >> This is a huge improvement. Responsive, excellent navigation, syntax >> >> highlighting, ... >> >> >> >> The only downside I see was already mentioned by Lee: the landing page >> is >> >> too empty (also in a mobile browser). >> >> I think we could really benefit from mentioning the unique selling >> point of >> >> Avro here: "Your Data. Any Time, Anywhere." And then mention the >> language >> >> availability & excellent schema evolution. >> >> >> >> Kind regards, >> >> Oscar >> >> >> >> On Thu, 28 Oct 2021 at 10:43, Martin Grigorov <[email protected]> >> wrote: >> >> >> >> > Hi all, >> >> > >> >> > Please check the new candidate for Apache Avro website: >> >> > https://avro-website.netlify.app/ >> >> > >> >> > It is based on Hugo and uses Docsy theme. >> >> > Its source code and instructions how to build could be found at >> >> > https://github.com/martin-g/avro-website. >> >> > The JIRA ticket is: https://issues.apache.org/jira/browse/AVRO-2175 >> >> > >> >> > I am not web designer, so some things may look not finished. >> >> > I've just copied the HTML content from the old site ( >> >> > https://avro.apache.org/) and converted it to Markdown for Hugo. >> >> > >> >> > Any feedback is welcome! With Pull Requests would be awesome! >> >> > >> >> > Regards, >> >> > Martin >> >> > >> >
