Many thanks to everyone for the feedback. I think the nature of the content fits slightly better under the community section rather than docs that others mentioned so I would say to start by putting things there. People have mentioned "External resources", "Learning resources" and I am fine with any of them. Even simply "Resources" could do the trick. Needless to say that if people want to improve the documentation by adding content, sections, etc., ideas and contributions are always welcome.
The list will definitely need curation but let's deal with this when the time comes. As a side note, personally I prefer having a dead link rather than no link at all. With a bit of luck, a dead link, and the internet archive [1], I am able to find pages that are no longer online which can be quite helpful sometimes. I would really like to see the News section becoming more active and Julian's idea about putting short articles there is great! Since we are not using it this way at the moment we may have to explicitly encourage people to post their work when we become aware of it. If someone creates an initial PR for the community content I will be happy to review, otherwise I will try to create one in the following weeks to move this forward. Best, Stamatis [1] https://archive.org/web/ On Tue, Jan 25, 2022 at 8:28 PM Nicola Vitucci <[email protected]> wrote: > +1 on the community content section, and +1 for the News section idea! > > Nicola > > > Il lun 24 gen 2022, 16:51 Julian Hyde <[email protected]> ha scritto: > > > I love the idea of community content. Some of these projects will be the > > next generation of Calcite, and the authors our next PMC members. > > > > I share people’s concerns about the list items going obsolete, or the > > getting too long. How about moving older items to the > > https://calcite.apache.org/community/#more-talks < > > https://calcite.apache.org/community/#more-talks> section, keeping only > > the 5 or 6 most recent, and removing obsolete items entirely? > > > > Also, any thoughts on using News for short articles about interesting > > projects? https://calcite.apache.org/news/ < > > https://calcite.apache.org/news/> News articles are easy to write (just > > one .md file) and the web site generator naturally puts recent articles > at > > the top of the page. > > > > Julian > > > > > On Jan 24, 2022, at 7:34 AM, Alessandro Solimando < > > [email protected]> wrote: > > > > > > +1 on the proposal, I share Ruben's POV also, but I think we can revise > > the > > > content from time to time and deprecate/remove links when they get > stale. > > > > > > Best regards, > > > Alessandro > > > > > > On Mon, 24 Jan 2022 at 16:29, Zhe Hu <[email protected]> wrote: > > > > > >> It’s definitely a terrific proposal, especially for those new comers > and > > >> people who want to share something useful with the community. > > >> > > >> > > >> I totally agree with what Jing Zhan and Ruben Q L mentioned, those > > useful > > >> stuff has higher requirements for authors and reviewers. What’s more, > > for > > >> each release, the RM might need to take a little while to briefly > check > > if > > >> those materials are still available. > > >> > > >> > > >> Still, +1 for this. > > >> > > >> > > >> Best, > > >> ZheHu > > >> > > >> > > >> On 01/24/2022 17:47，Ruben Q L<[email protected]> wrote： > > >> Thanks for the proposal Stamatis. > > >> > > >> I agree that such a section could be very helpful, especially for new > > >> comers. As you suggest, perhaps a new bullet "external resources" (or > > >> something like that) under the community page? > > >> > > >> I also share the concerns that Jing Zhang expressed. Moreover, > there's a > > >> risk that over the time some of the links that we share may become > > outdated > > >> or obsolete. > > >> > > >> Best, > > >> Ruben > > >> > > >> > > >> > > >> > > >> On Mon, Jan 24, 2022 at 3:20 AM Jing Zhang <[email protected]> > > wrote: > > >> > > >> Hi Stamatis, > > >> > > >> Thanks for driving this discussion. > > >> > > >> Big +1 on the idea. They are undoubtedly very helpful for newcomers to > > >> Calcite. I have heard a lot of requests in the dev mailing lists to > get > > >> more started documentation. > > >> > > >> At the same time, we need take careful to decide what contents to put > in > > >> this section. Because the content introduced on the community page > means > > >> that the content has been recognized by the community and is more > > >> authoritative. > > >> > > >> Best, > > >> Jing Zhang > > >> > > >> > > >> > > >> Stamatis Zampetakis <[email protected]> 于2022年1月24日周一 05:19写道： > > >> > > >> Hi all, > > >> > > >> Taking the recent email of Gavin [1] (sharing his article on GraphQL > to > > >> SQL > > >> conversion) as a motive, I wanted to see what people think of > creating a > > >> new section in the website for putting this and other useful stuff > such > > >> as > > >> Michael's notebooks, Querifylabs blogs [2], etc. > > >> > > >> We could have one or more new bullets under the community page [3]. > > WDYT? > > >> > > >> Best, > > >> Stamatis > > >> > > >> [1] https://lists.apache.org/thread/3kgwsg18bglszfm51ngy1m58fnh9dd2c > > >> [2] https://www.querifylabs.com/blog > > >> [3] https://calcite.apache.org/community/ > > >> > > >> > > >> > > > > >
