Hello! I realized that I haven't commented on this mailing list thread -- I made some comments on https://issues.apache.org/jira/browse/AVRO-2175
This looks amazing and we should merge it very soon :D It's not perfect, but it's really a great improvement and definitely not worst than the existing website! I've been taking a look at what we need to use the existing infrastructure, and there's interesting links at: - https://infra.apache.org/release-download-pages.html - https://cwiki.apache.org/confluence/display/INFRA/Git+-+.asf.yaml+features - https://infra.apache.org/website-guidelines.html - https://infra.apache.org/project-site.html I like that Beam has the website in the main repo, but notably the INFRA recommendation is that we use a separate repo for the website (named `avro-site` though). Any thoughts? It's always something we can try and change later! Would it make it easier for the javadoc and other languages if they were in the same repo, or does it make little difference? The old site actually contains all of the documentation for EVERY release, which can be found here: - https://svn.apache.org/repos/asf/avro/site/publish/docs/ - https://avro.apache.org/docs/ Would it be tricky to adjust your work to mirror the existing structure for existing docs? I'm not even too fussy about not breaking the links in /docs/current/ but all of the existing pages such as /docs/1.7.7/ should be maintained if possible! There's so many good suggestions here for future work and improving our message and communication, I created https://issues.apache.org/jira/browse/AVRO-3264 to point to this discussion after we get this up. Thanks again for your great work! Ryan On Thu, Nov 4, 2021 at 4:26 PM Lee Hambley <lee.hamb...@gmail.com> wrote: > > 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 <mgrigo...@apache.org> wrote: >> >> >> >> On Thu, Nov 4, 2021 at 5:04 PM Ismaël Mejía <ieme...@gmail.com> 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 <mgrigo...@apache.org> 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 >>> > <os...@westravanholthe.nl> 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 <mgrigo...@apache.org> >>> >> 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 >>> >> >
